Plataforma Fiscal – Varejo

Árvore de páginas

Visão Geral

Emissão de nota fiscal eletrônica (NF-e) é quando o estabelecimento precisa emitir um documento fiscal digital para operação de circulação de mercadorias ou prestação de serviços.

Emissão de NF-e via API

É 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"

}


É 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"
}

}

]}



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



É 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: