Get one

get

https://api.cardda.com/v1/fiscal_invoices/{fiscal_invoice_id}

Returns a single fiscal invoice (DTE) by its composite id. The response
includes the inline issuer and receiver projections (id, name,
identifier), the derived tradable and due_date, and the SII event fields
(sii_event_state, sii_event_status).

See the id format notes on GET /v1/fiscal_invoices — the id looks like
76123456-7-33-1234 and is a string, not a UUID.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

fiscal_invoice_id

string

required

Composite id of the fiscal invoice, "#{issuer_id}-#{document_type}-#{number}"
(e.g. 76123456-7-33-1234). This is a string, not a UUID.

Headers

company-id

uuid

required

UUID of the company on whose behalf the request is made. Fiscal-invoice endpoints
authorize the caller against this company (and read/write its data). SII-key
endpoints never filter their results by this header. On the SII-key list,
however, belonging to the header company is one of the ways a caller is authorized
to make the call (alongside being Cardda staff or passing their own user_id), so
the header is not merely ignored there. On the other SII-key endpoints the header
plays no part in authorization. See The company-id header
for details on how to obtain a value for this header and the error responses to
expect when it is missing or invalid.

Responses

401

Unauthorized — missing/invalid bearer token, company-id header not set,
or the caller is not a member of the invoice's company. Authorization
failures surface as 401 (not 403); Pundit renders 401 with an empty body.

404

Fiscal invoice not found (or not visible to the caller). Body: { "message": "Resource not found" }.

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Fiscal invoice