Skip to main content
POST
/
supplier-bills
/
sync
Trigger SPV sync
curl --request POST \
  --url https://api.contazen.ro/v1/supplier-bills/sync \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "days": 30
}'
{
  "success": true,
  "data": {
    "synced": 123,
    "created": 123,
    "updated": 123,
    "failed": 123,
    "xml_saved": 123,
    "invoices_imported": 123,
    "days_synced": 123,
    "errors": [
      "<string>"
    ]
  },
  "meta": {
    "version": "v1",
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "response_time": "23.45ms"
  }
}

​
Overview

Triggers a synchronous SPV pull for the authenticated firm: fetches messages from ANAF, downloads any missing XMLs, and imports received invoices. The call blocks until ANAF responds — typically 5–30 seconds, occasionally more.

​
Concurrency

A per-firm file lock prevents concurrent syncs. If a sync is already running for the same firm the endpoint returns HTTP 429 with code: "sync_in_progress" and a Retry-After header.

​
Choosing the window

Pass days (1–60) to fetch a fixed window. When omitted, Contazen picks the window automatically based on the time since the last successful sync (1 → 60 days).

Authorizations

​
Authorization
string
header
required

Use your API key (sk_live_xxx or sk_test_xxx)

Body

application/json
​
days
integer

How far back to fetch (1–60). When omitted, the window is chosen automatically based on the time since the last sync.

Required range: 1 <= x <= 60

Response

Sync result

​
success
boolean
​
data
object
​
meta
object