---
title: "Generate DC-e"
method: POST
path: "/dce/autorizar"
tags: ["DC-e"]
---

# Generate DC-e

`POST /dce/autorizar`

Authorize a DC-e with the /dce/autorizar endpoint and see request and response examples.

## Request body

- object
  - `ide` object — DC-e identification. Provide the emitter's state using either `uf` (abbreviation) or `cUF` (numeric IBGE code)
    - `uf` string — State abbreviation of the emitter. Converted to numeric IBGE code internally. Either `uf` or `cUF` must be provided
    - `cUF` string — Numeric IBGE state code of the emitter (2 digits). Alternative to `uf`
  - `emit` object, required — Emitter (sender) information — the person or company shipping the package
    - `CNPJ` string — Emitter CNPJ (14 digits). Dots, slashes, and dashes are removed automatically. Required if CPF is not provided
    - `CPF` string — Emitter CPF for individuals (11 digits). Required if CNPJ is not provided
    - `xNome` string, required — Emitter legal name or full name (2-60 chars). Must not have leading or trailing spaces — SEFAZ rejects with cStat=215
    - `endereco` object — Emitter address. If not provided, the address will be reported to FAZENDA as N/A
      - `logradouro` string, required — Street name (2-60 chars)
      - `numero` string, required — Street number (1-60 chars)
      - `complemento` string — Address complement — apartment, suite, etc. (1-60 chars)
      - `bairro` string, required — Neighborhood (2-60 chars). Use 'N/A' if not applicable — cannot be empty
      - `municipio` string — Municipality name. Resolved to IBGE code automatically. Required if `cod_municipio` is not provided
      - `cod_municipio` string — 7-digit IBGE municipality code. Required if `municipio` is not provided
      - `uf` string, required — State abbreviation (2 chars)
      - `cep` string, required — Postal code (CEP, 8 digits, no dashes)
      - `telefone` string — Phone number with area code (6-14 chars)
  - `dest` object, required — Recipient information
    - `CNPJ` string — Recipient CNPJ (14 digits). Required if CPF is not provided
    - `CPF` string — Recipient CPF for individuals (11 digits). Required if CNPJ is not provided
    - `xNome` string — Recipient name (2-60 chars). In homologation (tpAmb=2) SEFAZ overrides this with 'DCE EMITIDA EM AMBIENTE DE HOMOLOGACAO'
    - `endereco` object — Recipient address. Same structure as emit.endereco. If not provided, the address will be reported to FAZENDA as N/A
      - `logradouro` string, required — Street name (2-60 chars)
      - `numero` string, required — Street number (1-60 chars)
      - `complemento` string — Address complement — apartment, suite, etc. (1-60 chars)
      - `bairro` string, required — Neighborhood (2-60 chars)
      - `municipio` string — Municipality name. Resolved to IBGE code automatically
      - `cod_municipio` string — 7-digit IBGE municipality code
      - `uf` string, required — State abbreviation (2 chars)
      - `cep` string, required — Postal code (CEP, 8 digits, no dashes)
      - `telefone` string — Phone number with area code (6-14 chars)
  - `produtos` object[], required — List of declared products (min 1, max 999)
    - `xProd` string, required — Product description (1-120 chars). Avoid special characters like apostrophes
    - `NCM` string, required — NCM code (Nomenclatura Comum do Mercosul). 2 digits for chapter or 8 digits for full code, no dots. SEFAZ validates against MDIC table. If you don't know the NCM code, you can use the [Classify HS code](https://docs.envia.com/reference/classify-hs-code) endpoint to look it up from a product description
    - `qCom` string, required — Product quantity (up to 11 integer digits, 0-4 decimal places)
    - `vUnCom` string, required — Unit price (up to 11 integer digits, 0-4 decimal places). Use dot as decimal separator
    - `vProd` string, required — Total product value (qCom x vUnCom). Exactly 2 decimal places. Max per item R$100,000. Total DC-e max R$200,000
  - `transp` object, required — Transport information
    - `carrierName` string, required — Carrier name as registered in the envia.com catalog. Case-insensitive lookup
  - `infAdic` string — Additional information for the DC-e (1-5000 chars)

## Response `200`

Successful DC-e authorization

- object
  - `success` boolean — Whether the authorization was successful
  - `cStat` string — Status code returned by SEFAZ. 100 = Authorization approved
  - `xMotivo` string — Human-readable description of the authorization result
  - `documentType` string — Type of the returned document
  - `dceNumber` string — Generated DC-e number
  - `dceSerie` string — DC-e series number
  - `dceDate` string, date-time — DC-e emission date and time
  - `dceKey` string — 44-digit DC-e access key
  - `dceValue` string — Total value of the DC-e document
  - `nProt` string — Authorization protocol number from SEFAZ
  - `dhRecbto` string, date-time — Date and time when SEFAZ received and processed the authorization
  - `xml` string — Complete signed XML of the authorized DC-e document. Shown abbreviated in documentation for readability

---

[API](https://skmtc.net/envia/apis/envia-shipping-api-complete-documentation.md) · [All operations](https://skmtc.net/envia/apis/envia-shipping-api-complete-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/envia/envia-shipping-api-complete-documentation/revisions/39f9208959d6/schema)