DACE | Envio Fácil

DACE é o Documento Auxiliar da DC-e. Ele só pode ser gerado para um envio com etiqueta emitida e DC-e apta.

Tipos

Valor	Saída
`R`	DACE resumido em PDF; é o padrão.
`C`	DACE completo em PDF.
`T`	DACE térmico; pode retornar os dados diretamente.

Gerar

POST /api/v1/fiscal-documents/shipments/{shipmentId}/dace
Authorization: Bearer <accessToken>
X-Tenant-Id: <lojaId>
Content-Type: application/json

{
  "tipoDace": "R"
}

Resposta 201:

{
  "shipmentId": "6a4eaf6d-d962-4b0c-a421-f2d426128e92",
  "available": true,
  "generated": true,
  "fiscalDocumentStatus": "LINKED",
  "document": {
    "id": "d9114121-e05f-46f5-a487-efded7984891",
    "type": "DACE",
    "provider": "sefaz-pr-dce",
    "status": "READY",
    "fileUrl": "fiscal/loja/dace/arquivo.pdf",
    "payloadMeta": {
      "tipoDace": "R"
    },
    "providerReference": "referencia-fiscal",
    "createdAt": "2026-07-29T15:00:00.000Z"
  },
  "downloadUrl": "https://endereco-temporario.example/dace.pdf"
}

generated: false pode indicar que um documento compatível já existente foi reutilizado.

Consultar

GET /api/v1/fiscal-documents/shipments/{shipmentId}/dace

Use essa operação para verificar available, generated e o documento mais recente. document: null significa que ainda não há DACE processado.

Baixar

GET /api/v1/fiscal-documents/shipments/{shipmentId}/dace/download

Para PDF, a resposta contém downloadUrl e fileUrl. Para o tipo térmico, pode conter dados no lugar de uma URL.

As URLs são temporárias. fileUrl é referência interna.

Erros esperados

etiqueta ainda não emitida;
envio sem DC-e;
DC-e ainda não autorizada;
tipo não suportado pelo fluxo;
envio pertencente a outra loja;
documento ainda em processamento.

Não tente criar ou alterar a DC-e por rotas que não aparecem no Swagger externo.

Implemente o rastreamento →