Plataforma Fiscal – Varejo

Árvore de páginas

Versões comparadas

Versão antiga 1

changes.mady.by.user Suellen de Oliveira Baptista

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Suellen de Oliveira Baptista

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Visão Geral

...

Emissão de nota fiscal eletrônica (NF-e) é quando o estabelecimento precisa emitir um documento fiscal digital para A Nota Fiscal Eletrônica é um documento de existência apenas digital, emitido e armazenado eletronicamente, com o intuito de documentar, para fins fiscais, uma operação de circulação de mercadorias ou prestação de serviços, ocorrida entre as partes (emitente e destinatário). Sua validade jurídica é garantida pela assinatura digital do emissor (garantia de autoria e de integridade) e pela recepção, pelo Fisco, do documento eletrônico.

Processo

A integração envolve o ERP, TPF (Totvs Processos Fiscais) e SEFAZ (Secretaria de Estado da Fazenda) e prevê dois fluxos: emissão iniciado pelo ERP e recebimento dos documentos emitidos contra o CNPJ do ERP.

Emissão de NF-e:

  1. ERP envia o XML da NF-e para o TPF;
  2. TPF valida o Schema da XML da NF-e;
  3. Se XML for validada então é transmitida para a sefaz, caso seja rejeitada XML retorna para o ERP;
  4. TPF transmite NF-e para a Secretaria da Fazenda;
  5. Secretaria da Fazenda processa NF-e e retorna XML;
  6. Secretaria da Fazenda disponibiliza XML com o retorno da situação da NF-e;
  7. TPF busca XML validada na SEFAZ;
  8. ERP busca XML no TPF.

...

.

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

}

]}



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

...

Recepção NF-e (MD-e Manifestação do Destinatário Eletrônico):

  1. TPF consulta NF-e emitidas contra o CNPJ do estabelecimento na SEFAZ;
  2. Secretaria da Fazenda retorna a lista dos documentos;
  3. TPF solicita a manifestação: "ciência da operação" da NF-e na SEFAZ;
  4. Secretaria da Fazenda retorna XML para o TPF;
  5. TPF realiza a custodia dos documentos e envia para o ERP;
  6. ERP realiza a custodia dos documentos.

...



Assuntos Relacionados:

Page Tree
root@self