Emitir

post

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

Cria uma DCe e a envia para processamento.

O envio é síncrono: a DCe é autorizada ou rejeitada na mesma requisição. A resposta contém o mesmo formato da operação de consulta.

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).

nome_emitente

string

Razão social ou nome do emitente.

tipo_emitente

string

enum

required

Tipo do Emitente da DCe.
1: Marketplace

2: Emissor próprio

3: Transportadora

4: ECT

Allowed:

cnpj_remetente

string

CNPJ do remetente (somente números).

cpf_remetente

string

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

nome_remetente

string

Razão social ou nome do remetente.

logradouro_remetente

string

Logradouro do endereço do remetente.

numero_remetente

string

Número do endereço do remetente.

complemento_remetente

string

Complemento do endereço do remetente.

bairro_remetente

string

Bairro do endereço do remetente.

codigo_municipio_remetente

string

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

municipio_remetente

string

Nome do município do remetente.

uf_remetente

string

Sigla da UF do remetente.

cep_remetente

string

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

telefone_remetente

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

201Recurso criado com sucesso

401Não autorizado

403Ação não permitida