е-Фактура API

Грешки

Секоја грешка е application/problem+json (RFC 9457), освен POST /v1/oauth/token, кој користи обичен OAuth 2.0 JSON формат за грешки.

{
  "type": "https://developer.merot.com/efaktura/errors#validation_failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "One or more fields failed UJP validation.",
  "instance": "req_01J9Z5C6D7E8F9G0H1J2K3",
  "code": "validation_failed",
  "errors": [
    { "path": "lines[2].taxIndicator", "message": "Unknown tax indicator for document type 100.", "codebook": "tax-indicators" }
  ]
}

instance е ID на барањето — истиот се наоѓа и во заглавието X-Request-Id; наведете го кога контактирате поддршка.

Кодови

Код	Статус	Значење
`unauthenticated`	401	Недостасуваат, се неважечки или истечени акредитиви.
`key_revoked`	401	API клучот е укинат.
`insufficient_scope`	403	Клучот/токенот нема потребна дозвола (scope).
`company_not_allowed`	403	Компанијата не е во листата на дозволени за овој клуч.
`environment_mismatch`	403	Sandbox клуч пристапил до продукциски ресурс, или обратно.
`production_not_enabled`	403	Сметката сè уште нема активен продукциски план.
`company_required`	400	Задолжително е `X-Company-Id` (сметката има повеќе од една компанија).
`idempotency_key_required`	400	На пишување недостасува заглавието `Idempotency-Key`.
`idempotency_conflict`	409	Истиот клуч е повторно искористен со различно тело на барањето.
`idempotency_in_progress`	409	Барање со овој клуч сè уште се обработува.
`client_reference_conflict`	409	Истата `clientReference` е повторно искористена со различно тело.
`period_closed`	409	Сторно/корекција блокирани — годишната сметка е поднесена за таа година.
`decision_deadline_passed`	409	Рокот за прифаќање/одбивање на влезен документ поминал.
`signature_expired`	410	Барањето за потпис истекло пред да пристигне потпис.
`signature_invalid` / `payload_mismatch` / `certificate_mismatch`	422	Поднесениот потпис не поминал проверка.
`validation_failed`	422	Грешки на ниво на поле, или `totals_mismatch` за неусогласени вкупни износи.
`pdf_not_ready`	409	Документот сè уште не е финализиран кај УЈП.
`rate_limited`	429	Премногу барања — видете Ограничувања на бројот на барања.
`not_found`	404	Не постои таков ресурс за оваа компанија.
`ujp_unavailable`	503	Синхроната предпроверка во регистарот на УЈП (при создавање компанија) истекла.

Грешки потекнуваат од УЈП

Кога грешка при валидација доаѓа директно од правило во шифрарник на УЈП, errors[].codebook го наведува тој шифрарник, за да можете сами да ја проверите вредноста — Merot никогаш не ги преименува ниту реинтерпретира кодовите на УЈП.