How the SRI is answering
Whether the SRI is slow to receive or decide your documents in the key's environment right now, so a client deciding whether to wait or retry knows. Read from your own documents in one pass; the SRI is never asked.
AuthorizationBearer <token>Your API key, which acts for the one business it was created for: fb_live_… keys work at api.fiscalbase.io and issue in live, and fb_sandbox_… keys work at api-sandbox.fiscalbase.io and issue in sandbox, on the simulated SRI. A key sent to the other host is refused with api_key_wrong_host, which names its host.
Fiscalbase-Environment?stringThe environment the call acts in. Required with a person's session; a key's own environment is the one that counts, so a key may leave it out, and naming another is 422 environment_mismatch.
"sandbox""test""live"Fiscalbase-Business?stringThe business the call acts for. With a person's session, the one the call is about (without it, a call about one business is 422 business_required and a list covers every business of the organization); a key acts for its own, so naming another is 422 business_mismatch.
uuidFiscalbase-Channel?stringWhich of Fiscalbase's own integrations a key's call comes from, recorded as the channel of the documents it issues: a record, not a permission. Without it, api. A person's call is always console.
"api""mcp"Fiscalbase-Agent?stringThe AI agent a key's call comes from, as its client names itself (the MCP server sets it); recorded with the request and shown in the console's request log.
The SRI's state
application/json- response
object*"sri_status""sri_status"environment*string"sandbox""test""live"status*stringslow when one of your documents has waited more than 5 minutes for the SRI to receive it or more than 10 for its decision; ok otherwise. Judged by your own documents in the environment, not by asking the SRI.
"ok""slow"waiting_reception*integerYour documents the SRI hasn't received yet (pending).
waiting_decision*integerYour documents the SRI received and hasn't decided yet (submitted).
oldest_waiting_since*|When the document that has waited longest started waiting; null when none waits.
date-timecurl -X GET 'https://api.fiscalbase.io/v1/ec/sri/status'{
"object": "sri_status",
"environment": "sandbox",
"status": "ok",
"waiting_reception": 0,
"waiting_decision": 0,
"oldest_waiting_since": "2019-08-24T14:15:22Z"
}Retrieve a document of any type GET
The document with this id, whatever its type: its `type` says which. For whoever only has the id, such as a link to the console.
Record the annulment of invoice POST
Only records an annulment you already made in the SRI's online portal; it does not request it from the SRI. The document goes to `annulled`, keeps its files, leaves your customer's portal and `<type>.annulled` is sent to your webhooks. Only for an `authorized` one, and never for one issued to a `consumidor_final` buyer, which the SRI does not annul.