Histórico da Página

...

É possível emitir NF-e via API de duas formas no formato XML.

1. API para emissão de NF-e

*Método:*	POST
*Descrição:*	Utilize este recurso para enviar a emissão de NF-e no formato XML
Endpoint:	https://plataformafiscal.totvs.com.br/api/v1/nfe/emissao-xml
*Modelo JSON (Envio):*	{ "xml": "<NFe>...Informações da nota fiscal eletrônica...</NFe>" }
Observação:	Precisa escapar as aspas que contem no XML (<NFe></NFe>). Ex.: versao=\"4.00
*Modelo JSON (Retorno):*	{ "id": "61e85165e4b00929510dec79", "cnpj": "CNPJ do emitente", "numeroRecibo": "351000163344682", "codigoStatus": 103, "descricaoCodigoStatus": "Lote recebido com sucesso", "codigoUf": "35" }Obs.: Precisa escapar as apas

É possível consultar esse ID no endpoint: https://plataformafiscal.totvs.com.br/api/v1/nfe/consulta-lote/{id}

*Método:*	GET
*Descrição:*	Utilize este recurso para consultar o histórico da NF-e por id
Endpoint:	https://plataformafiscal.totvs.com.br/api/v1/nfe/emissao-xml
*Modelo JSON (Envio):*	{ "xml": "<NFe>...Informações da nota fiscal eletrônica...</NFe>" }
Observação:	Precisa escapar as aspas que contem no XML (<NFe></NFe>). Ex.: versao=\"4.00
*Modelo JSON (Retorno):*	{ "id": "61e85165e4b00929510dec79", "cnpj": "CNPJ do emitente", "numeroRecibo": "351000163344682", "codigoStatus": 103, "descricaoCodigoStatus": "Lote recebido com sucesso", "codigoUf": "35" }

2. API para emissão de NF-e - Fluxo 170

*Método:*	POST
*Descrição:*	Utilize este recurso para enviar a emissão de NF-e no formato XML do fluxo 170
Endpoint:	https://plataformafiscal.totvs.com.br/api/v1/integracao-nfe
*Modelo JSON (Envio):*	{ "integracoes": [ { "nomeArquivo": "170_35210282373077000265652480000032081352517279_0030.xml", "fluxo": "EMISSAO_NFE", "xml": " <NFe>...Informações da nota fiscal eletrônica...</NFe>" } ] }
Observação:	Precisa escapar as aspas que contem no XML. Ex.: versao=\"4.00
*Nomenclatura do Arquivo:*	xxx_zzzzzzzzzzzzzzzzzzzzzzzzz_yyyy - xxx: Identificação do tipo do arquivo - 3 dígitos. Valores válidos: 170: Arquivo de mensageria da NF-e para a SEFAZ. - zzz: Chave de Acesso ou Data/Hora da operação (com milissegundos) - yyyy**: Número aleatório ou o código da impressora cadastrado no Totvs Processos Fiscais (Caso utilize o SIL)- 7 dígitos Ex. DataHora: 170_2020122155530305_905.xml Ex. Chave de Acesso.: 170_35210282373077000265652480000032081352517279_0030.xml
*Modelo JSON (Retorno):*	{"ids": ["61e84c1de4b00929515dec78"]}

É possível consultar esse ID no endpoint: https://plataformafiscal.totvs.com.br/api/v1/integracao-nfe/{id}

*Método:*	GET
*Descrição:*	Utilize este recurso para consultar o histórico da NF-e por id, quando a NF-e emitida no fluxo 170.
Endpoint:	https://plataformafiscal.totvs.com.br/api/v1/integracao-nfe/{id}
*Modelo JSON (Retorno):*	{"integracoes": [ { "idIntegracao": "61e84c1de4b00929515dec78", "cnpj": "CNPJ do Emitente", "nomeArquivo": "170_35210282373077000265652480000032081352517279_0030_2589.xml", "xml": "<retEnviNFe xmlns=\"http://www.portalfiscal.inf.br/nfe\" versao=\"4.00\">...Lote recebido com sucesso...<\/retEnviNFe>", "fluxo": "EMISSAO_NFE", "imprimivel": true, "statusSefaz": { "codigoStatus": "103", "descricaoCodigoStatus": "Lote recebido com sucesso" } }, { "idIntegracao": "61e84c1de4b00929515dec78", "cnpj": "CNPJ do Emitente", "nomeArquivo": "170_35210282373077000265652480000032081352517279_0030_5624.xml", "xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><nfeProc versao=\"4.00\" xmlns=\"http://www.portalfiscal.inf.br/nfe\" >...Informações da NF-e com o protocolo de autorização..<\/nfeProc>", "fluxo": "EMISSAO_NFE", "imprimivel": true, "statusSefaz": { "codigoStatus": "100", "descricaoCodigoStatus": "Autorizado o uso da NF-e" } } ]}

Aviso
Lembrando que para emitir NF-e é necessário configurar o certificado digital no cadastro do estabelecimento no Totvs Processos Fiscais (Importar Certificado Digital).

Dica

É possível realizar a emissão de NF-e enviando o arquivo XML para o TPF através do Fiscal Sycn, em caso de dúvida favor verificar a documentação do Fiscal Sync:

Conhecendo o Fiscal Sync

Manual de Instalação - Fiscal Sync

Assuntos Relacionados:

Page Tree

root	@self

...

Árvore de páginas

Versões comparadas

Versão antiga 17

Nova versão Atual

Chave