Fiscal Contora | Status e artefatos

Status e consulta

Existem duas formas principais de acompanhar o documento (válido para NF-e/NFC-e, CT-e e MDF-e):

GET https://fiscal.contora.com.br/api/v1/[nfe|cte|mdfe]/drafts/{document}/status (Global - Recomendado)

GET https://fiscal.contora.com.br/api/v1/companies/{company}/[nfe|cte|mdfe]/drafts/{document}/status (Hierárquico)

GET https://fiscal.contora.com.br/api/v1/nfe/access-keys/{accessKey}/status (Global - Recomendado)

GET https://fiscal.contora.com.br/api/v1/companies/{company}/nfe/access-keys/{accessKey}/status (Hierárquico)

{
  "ok": true,
  "data": {
    "id": "18f017f7-a69c-4fa6-89c7-05f52fcc8be4",
    "lifecycle": {
      "status": "authorized",
      "processing_status": "completed",
      "requested_action": "authorize"
    },
    "sefaz": {
      "status_code": "100",
      "status_message": "Autorizado o uso da NF-e",
      "access_key": "00000000000000000000000000000000000000000000",
      "receipt_number": "123456789012345",
      "protocol": "143260000000001",
      "authorized_at": "2026-07-01T14:22:11-03:00"
    },
    "latest_fiscal_event": null,
    "fiscal_events_count": 0
  }
}

Estados oficiais da v1

status

draft, built_unsigned, built_signed, authorize_pending, authorized, error

processing_status

draft, queued, processing, completed, failed

requested_action

build_unsigned, build_signed, authorize, cancel, correction, close

Como interpretar o ciclo de vida

Quando esta tudo bem status=authorized e processing_status=completed. Nessa fase, chave, protocolo, XML e DANFE ja podem ser tratados como parte da rotina operacional.

Quando ainda não terminou status=authorize_pending ou processing_status=queued/processing. O correto e esperar reconciliacao e webhook, sem reenviar por ansiedade.

Quando houve erro técnico processing_status=failed costuma apontar excecao de job, fila, certificado, rede ou dependencia externa.

Quando houve rejeicao de negocio status=error com retorno fiscal preenchido costuma indicar rejeicao SEFAZ ou problema de consistencia documental.

Artefatos

Depois da emissão, a plataforma disponibiliza XMLs e PDF do DANFE, além de artefatos agregados e eventos processados.

GET https://fiscal.contora.com.br/api/v1/[nfe|cte|mdfe]/drafts/{document}/artifacts (Global - Recomendado)

GET https://fiscal.contora.com.br/api/v1/companies/{company}/[nfe|cte|mdfe]/drafts/{document}/artifacts (Hierárquico)

GET https://fiscal.contora.com.br/api/v1/[nfe|cte|mdfe]/drafts/{document}/artifacts/{artifact} (Global - Recomendado)

GET https://fiscal.contora.com.br/api/v1/companies/{company}/[nfe|cte|mdfe]/drafts/{document}/artifacts/{artifact} (Hierárquico)

xml_unsigned
xml_signed
xml_authorized
xml_aggregated
pdf_danfe
xml_cancelled
xml_correction
proc_event_cancellation_latest
proc_event_correction_latest

Ver eventos fiscais Ver webhooks Abrir debug

Acompanhe status, chave de acesso e artefatos do documento sem travar o ERP.

Status e consulta

Estados oficiais da v1

Como interpretar o ciclo de vida

Artefatos