NF-e e CT-e Recebidos

Integrações disponíveis via arquivo visando a integração com ERP baseada nas ações dos usuários.

Fluxo no processo de recebimento no ERP:

1. Portal captura o xml da Sefaz ou e-mail monitorado
2. Portal Adiciona na fila de download para o integrador
3. Integrador baixa o xml para a pasta parametrizada na Empresa
4. ERP lê o XML na pasta disponibilizando ao usuário para lançamendo
5. ERP após o lançamento do documento, gera os arquivos abaixo de acordo com o processo desejado
6. Integrador lê os arquivos gerados pelo ERP e comunica com o portal para executar as ações com base nos arquivos

Somente os passos 4 e 5 precisam ser desenvolvidos no ERP para ter a integração completa com nosso produto.

Os ERPs oficialmente integrados ao nosso sistema já utilizam esse processo de forma automática, não sendo necessário nenhum desenvolvimento para integração.

---

Flag lançada no ERP

Arquivo responsável por marcar a coluna Lançada ERP quando o usuário faz o lançamento/classificação do documento (NFe/CTe) no ERP.

O Arquivo abaixo deve ser criado no diretório de ações do usuário parametrizado no Portal em Integradores >> Recebidas (Parametrizações das pastas).

Atualizada no ERP (lançada)

Marca a flag Lançada ERP

• Nome do arquivo que deve ser gerado na pasta

{chaveacesso}.erp.json

• Conteúdo do arquivo .json

{
    "chave": "43151095816963003513550000000001691000000005",
    "comando": "ATUALIZAR",
    "data": 1546625378000,
    "codUsuarioErp": "000001",
    "nomeUsuarioErp": "Felipe"
}

No campo data, deve ser informado o timestamp da data do evento em milisegundos.

Os campos data, codUsuarioErp e nomeUsuarioErp são opcionais, mas caso enviados, será possível ter acesso aos dados no histórico mais detalhado no documento.

Desatualizada no ERP (lançamento excluído)

Desmarca a flag Lançada ERP

• Nome do arquivo que deve ser gerado na pasta

{chaveacesso}.erp.json

• Conteúdo do arquivo .json

{
    "chave": "43151095816963003513550000000001691000000005",
    "comando": "DESATUALIZAR",
    "data": 1546625378000,
    "codUsuarioErp": "000001",
    "nomeUsuarioErp": "Felipe"
}

---

Envio do manifesto pelo ERP

Arquivo responsável por enviar para a SEFAZ o manifesto do destinatário após o lançamento/classificação da NF-e no ERP.

Esse arquivo não deve ser gerado para CT-e, pois o mesmo não possui manifestação do destinatário.

O Arquivo abaixo deve ser criado no diretório de ações do usuário parametrizado no Portal em Integradores >> Recebidas (Parametrizações das pastas).

• Nome do Arquivo que deve ser gerado na pasta

{chaveacesso}-{codTipoEvento}.man.json

• Conteúdo do arquivo .json

{
    "chaveAcessoNFe": "43151095816963003513550000000001691000000005",
    "codTipoEvento": "210200",
    "data": 1546625378000,
    "codUsuarioErp": "000001",
    "nomeUsuarioErp": "Felipe"
}

Só são suportados envios dos manifestos de Ciência e Confirmação da Operação.

Os campos data, codUsuarioErp e nomeUsuarioErp são opcionais, mas caso enviados, será possível ter acesso aos dados no histórico mais detalhado no documento.

---

Envio de alertas pelo ERP

Arquivo responsável por enviar validações internas do ERP ao receber os documentos do portal.
Ex.: Fornecedor ou Parceiro de Negócios não cadastrado, documento cancelado já está lançado no sistema, entre outros.

O Alerta seré exibido nas notificações do sistema e também uma observação na coluna ERP do respectivo documento.

Comandos:

"ALERTA_1" = INFO
"ALERTA_2" = WARNING
"ALERTA_3" = ERROR

• Nome do arquivo sugerido:

{chaveacesso}.erp.json

• Conteúdo do arquivo .json

{
    "chave": "43151095816963003513550000000001691000000005",
    "comando": "ALERTA_3",
    "data": 1546625378000,
    "codUsuarioErp": "000001",
    "nomeUsuarioErp": "Rodrigo",
    "origem": "INTEGRADOR_RM",
    "mensagem": "CNPJ do Prestador não cadastrado no ERP"
}

---

Chave de Acesso/Id para NFS-e

Como a nota fiscal de serviço não tem padrão de identificação único, para integração do Alerta ou Flag ERP, definimos o padrão abaixo para que seja possível identificar o documento de forma segura:

"nfse" + codigo_do_municipio + cnpj_prestador + numero_nfse + cod_verificacao