Emitir

post

https://api.focusnfe.com.br/v2/dce

Quando uma DCe é enviada para processamento, é realizada uma pré-validação, caso ocorra algum problema como: ausência de campos essenciais, formato de dados incorreto ou problemas com o cadastro do emitente em nossa base, a DCe não será aceita e você receberá uma mensagem de erro de forma síncrona.

Caso a DCe seja aceita para processamento, ela será enviada para uma fila e será processada de forma assíncrona. Com isto, a DCe poderá ser autorizada ou retornar um erro, de acordo com a validação do autorizador nacional.

Para verificar se a DCe já foi autorizada, você terá que efetuar uma consulta ou se utilizar de webhooks (gatilhos).

Abaixo você poderá verificar uma listagem dos principais campos disponíveis. Para verificar a listagem completa de campos veja o link a seguir.

Documentação completa de campos da DCe

Query Params

ref

string

required

Referência única da DCe

Body Params

cnpj_emitente

string

required

CNPJ do emitente (somente números).

cpf_emitente

string

CPF do emitente (somente números). Informar quando não houver CNPJ.

tipo_emitente

string

enum

required

Tipo do Emitente da DCe. 1=Marketplace, 2=Emissor próprio, 3=Transportadora, 4=ECT.

Allowed:

nome_emitente

string

Razão social ou nome do emitente.

logradouro_emitente

string

Logradouro do endereço do emitente.

numero_emitente

string

Número do endereço do emitente.

complemento_emitente

string

Complemento do endereço do emitente.

bairro_emitente

string

Bairro do endereço do emitente.

codigo_municipio_emitente

string

Código IBGE do município do emitente (7 dígitos).

municipio_emitente

string

Nome do município do emitente.

uf_emitente

string

Sigla da UF do emitente.

cep_emitente

string

CEP do endereço do emitente (8 dígitos).

telefone_emitente

string

Telefone do emitente (7 a 12 dígitos).

cnpj_destinatario

string

CNPJ do destinatário (somente números).

cpf_destinatario

string

CPF do destinatário (somente números). Informar quando não houver CNPJ.

nome_destinatario

string

required

Razão social ou nome do destinatário.

logradouro_destinatario

string

Logradouro do endereço do destinatário.

numero_destinatario

string

Número do endereço do destinatário.

complemento_destinatario

string

Complemento do endereço do destinatário.

bairro_destinatario

string

Bairro do endereço do destinatário.

codigo_municipio_destinatario

string

Código IBGE do município do destinatário (7 dígitos).

municipio_destinatario

string

Nome do município do destinatário.

uf_destinatario

string

Sigla da UF do destinatário.

cep_destinatario

string

CEP do endereço do destinatário (8 dígitos).

codigo_pais_destinatario

string

Código do país do destinatário (tabela BACEN). Fixo 1058 para Brasil.

nome_pais_destinatario

string

Nome do país do destinatário.

telefone_destinatario

string

Telefone do destinatário (7 a 12 dígitos).

email_destinatario

string

E-mail do destinatário.

cnpj_marketplace

string

CNPJ do Marketplace. Obrigatório quando tipo_emitente=1 (Marketplace).

nome_marketplace

string

Razão Social ou Nome do Marketplace.

site_marketplace

string

Endereço ou site do Marketplace.

cnpj_transportadora

string

CNPJ da Transportadora contratada. Obrigatório quando tipo_emitente=3 (Transportadora).

nome_transportadora

string

Razão Social ou Nome da Transportadora contratada.

cnpj_ect

string

CNPJ dos Correios. Obrigatório quando tipo_emitente=4 (ECT).

nome_ect

string

Razão Social ou Nome dos Correios.

itens

array of objects

required

Lista de itens da DCe (1 a 999 itens).

itens*

valor_total

string

Valor total da DCe. Se não informado, será calculado automaticamente pela soma dos itens.

modalidade_transporte

string

enum

required

Modalidade do transporte. 0=Correios, 1=Conta própria, 2=Empresa transportadora.

Allowed:

cnpj_transporte

string

CNPJ da empresa responsável pelo transporte físico da mercadoria. Pode diferir da Transportadora contratada.

informacoes_complementares

string

Informações complementares de interesse do emitente (até 5000 caracteres).

informacoes_adicionais_fisco

string

Informações adicionais de interesse do Fisco (até 2000 caracteres).

informacoes_adicionais_marketplace

string

Informações adicionais do Marketplace (até 5000 caracteres).

informacoes_adicionais_ect

string

Informações adicionais dos Correios (até 5000 caracteres).

observacoes_emitente

array of objects

Campos de uso livre do emitente (até 10).

observacoes_emitente

observacoes_fisco

array of objects

Campos de uso livre do Fisco (até 10).

observacoes_fisco

observacoes_marketplace

array of objects

Campos de uso livre do Marketplace (até 10).

observacoes_marketplace

observacoes_ect

array of objects

Campos de uso livre dos Correios (até 10).

observacoes_ect

autorizados_download_xml

array of objects

Autorizados para acessar o XML da DCe (até 10).

autorizados_download_xml

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

202Requisição aceita para processamento

401Não autorizado

403Ação não permitida