Brivio API reference
Saft

Apply a previewed SAF-T import: contacts, products, account links, opening stock and opening balances (one posted, immutable OP entry). 409 when already applied or opening balances are already posted. (scope: saft_import:write)

POST
/saft/imports/{id}/apply

Authorization

bearerAuth
headerAuthorizationBearer <token>

API key as Bearer token

Path Parameters

id*string

SAF-T import id

Formatuuid

Header Parameters

Idempotency-Key*string

Required. Retries with the same key replay the first response instead of starting a second job (24 h).

Lengthlength <= 200

Request Body

application/json
  1. body
sections?

Every section defaults to true.

migration_date?string

Defaults to the file's period end.

Formatdate
account_mapping?

Foreign AccountID → RO account code, for the opening balance.

Response Body

OK

application/json
  1. response
data*
error*null
curl -X POST "https://example.com/saft/imports/497f6eca-6276-4993-bfeb-53cbbbba6f08/apply" \  -H "Idempotency-Key: string" \  -H "Content-Type: application/json" \  -d '{}'
{  "data": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "status": "awaiting_upload",    "filename": "string",    "byte_size": 0,    "sha256": "string",    "has_file": true,    "storage_expires_at": "2019-08-24T14:15:22Z",    "preview": {      "header": {        "taxRegistrationNumber": "string",        "companyName": "string",        "startDate": "string",        "endDate": "string",        "currency": "string"      },      "counts": {        "accounts": 0,        "parties": 0,        "invoices": 0,        "products": 0,        "physical_stock": 0,        "journal_entries": 0,        "payments": 0,        "assets": 0      },      "trial_balance": {        "rows": [          {            "account_code": "string",            "debit": 0,            "credit": 0          }        ],        "total_debit": 0,        "total_credit": 0,        "balanced": true      },      "control_total_mismatches": [        "string"      ],      "warnings": [        "string"      ],      "unknown_accounts": [        "string"      ],      "has_stock_section": true    },    "result": {},    "imported_count": 0,    "updated_count": 0,    "skipped_count": 0,    "error_count": 0,    "errors": [      {        "row": 0,        "field": "string",        "message": "string"      }    ],    "created_at": "2019-08-24T14:15:22Z",    "finished_at": "2019-08-24T14:15:22Z"  },  "error": null}

Create or fetch a member by externalRef or customerId; 201 when created (scope: rewards:write) POST

Previous Page

Queue a SAF-T D406 generation on the worker (never rendered inline). 409 when the readiness pre-flight has blocking findings or a generation is already running; 503 when no worker is reachable. (scope: saft:write) POST

Next Page