Para documentos de entrada, estão disponíveis dois tipos de integração: Integração baseada em Arquivo e Integração baseada em Banco de Dados.
Na integração baseada em arquivo, os documentos são retornados em um repositório padrão, configurados através do e-Connector Settings. Os arquivos retornados nesse diretório podem ser:
Para NF-e: do tipo XML ou arquivo texto delimitado (TXT);
Para CT-e: do tipo XML ou arquivo texto delimitado (TXT);
O arquivo retornado será gravado com a seguinte nomenclatura:
•Para as integrações em formato TXT, será efetuada conversão do arquivo XML para o TXT Delimitado NDDigital, neste processo caracteres especiais do XML como & que representa &, serão removidos. |
Nome do arquivo:
<chave de acesso>_<data>_<hora>_<tipo>.txt
<chave de acesso>_<data>_<hora>_<tipo>.xml
Nome do arquivo de eventos:
<chave de acesso>_<tpEvento>_<data>_<hora>_<tipo>.txt
<chave de acesso>_<tpEvento>_<data>_<hora>_<tipo>.xml
Conteúdo do arquivo:
<chave de acesso> = Chave de 44 posições do documento.
<tpEvento> = Código do tipo do evento (exclusivo para retornos de evento)
<data> = Data de retorno do documento no formato ano, mês, dia. Ex.: 20080120
<hora> = Hora de gravação do documento no formato hora, minuto e segundo. Ex.: 142056
<tipo> = tipo de documento resultante onde:
env
Resulta de um processo de ENVIO (procNFe ou procCTe ou procMDFe);
canc
Resulta de um processo de CANCELAMENTO (procCancNFe ou procCancCTe);
canc2
Resulta de um processo de CANCELAMENTO REDUZIDO;
erro
Resulta de um processo com o arquivo mal formado;
evt
Resulta de um processo de EVENTO NF-e (Manifestação do destinatário);
procevt
Resulta de um processo de EVENTO NF-e (Carta de Correção, Cancelamento ou Averbação da exportação (DF-e)), CT-e 2.00 (Carta de Correção, Cancelamento ou Evento de Registro de Multimodal) e MDF-e (Cancelamento, Encerramento, Inclusão de condutor e Inclusão de DF-e);
consulta de dest
Resulta de um processo de Envio onde houve a recepção do documento para a modalidade de consulta de documentos destinados ("ped-list").
DFe
Resulta de um processo de Envio onde houve a recepção do documento para a modalidade de consulta de documentos destinados via WS de distribuição ("ped-DFe").
audit
Resulta de um processo de ENVIO do documento para Vaccine.
ade
Resulta de um processo de ENVIO onde houve a rejeição do documento para AD-e.
•A nomenclatura anterior é apenas uma sugestão, podendo ser alterada como desejado, através do menu “Integrações” no e-Connector Settings. Para maiores informações, consultar o Manual de Configuração e-Forms. |
Exemplo: Nome de arquivo completo para retorno de ENVIO:
43080190347840002323550000000037681000037684_20080120_142056_env.txt |
|||
<chave de acesso> |
<data> |
<hora> |
<tipo> |
Exemplo: Nome de arquivo completo para retorno de EVENTO:
43080190347840002323550000000037681000037684_110110_20080120_142056_evt.txt |
||||
<chave de acesso> |
<tpEvento> |
<data> |
<hora> |
<tipo> |
Outra forma de realizar a integração dos retornos de notas de entrada é utilizar a integração baseada em banco de dados. Esta integração pode ser utilizada com qualquer um dos seguintes SGBD’s:
Microsoft SQL Server 2005;
Microsoft SQL Server 2008;
Microsoft SQL Server 2012;
Microsoft SQL Server 2014;
MySQL 5.1;
Oracle 10g;
Oracle 11g;
Oracle 12c;
IBM DB2 versão 9;
Informix 9.40;
Informix 11.50.
A tabela de integração de retornos de notas de entrada deverá possuir, obrigatoriamente, as colunas a seguir:
DOCUMENTDATA – conteúdo do documento retornado;
STATUS – será inserido sempre com o valor ZERO, permitindo que o ERP ou outro sistema possa controlar a captura dos registros;
KIND – Campo obrigatório que determina para o sistema que fará a leitura do registro, qual o tipo de retorno consta no registro. Este campo pode receber os seguintes valores:
0 – Envio;
1 – Cancelamento;
2 – Rejeição;
3 – Cancelamento reduzido;
4 – Evento (Carta de Correção, Cancelamento, Evento de Registro de Multimodal e Evento de Averbação da exportação);
5 – Evento de Manifestação do Destinatário;
6 – Retorno de Consulta de documentos Destinados (ped-list);
7 - Retorno auditoria Vaccine;
8 – Retorno de Consulta de documentos Destinados via WS de DF-e (ped-DFe);
9 – Rejeição ADe.
•A tabela de integração de retornos de notas de entrada pode possuir colunas adicionais, para controles do ERP, porém, estas alterações sobre a estrutura padrão devem ser reportadas à NDDigital, a qual fará a análise evitando que ocorram problemas como concorrência de banco de dados, entre outros. |
A seguir, serão listados os scripts de criação da estrutura padrão, nos diferentes SGBD’s suportados:
a)SGBD SERVER 2005 / MSSQL SERVER 2008 / MSSQL SERVER 2012 / MSSQL SERVER 2014
CREATE TABLE [dbo].[entryIntegration]( [entryIntegrationId] [bigint] IDENTITY(1,1) NOT NULL, [documentdata] [text] NOT NULL , [status] [int] NOT NULL , [kind] [int] NOT NULL CONSTRAINT [PK_ entryIntegration] PRIMARY KEY CLUSTERED ( [entryIntegrationId] ASC )WITH (PAD_INDEX = OFF, IGNORE_DUP_KEY = OFF) ON [PRIMARY] ) ON [PRIMARY] |
b)SGBD ORACLE
/ CREATE TABLE entryIntegration ( entryIntegrationId number(20) NOT NULL, documentdata blob NOT NULL , status int NOT NULL , kind int NOT NULL ) / CREATE SEQUENCE "entryIntegration_SEQ" INCREMENT BY 1 START WITH 1 MAXVALUE 1.0E28 MINVALUE 1 NOCYCLE CACHE 20 NOORDER / CREATE OR REPLACE TRIGGER "BI_entryIntegration" BEFORE INSERT ON entryIntegration FOR EACH ROW WHEN (new.entryIntegrationId IS NULL) BEGIN SELECT "entryIntegration_SEQ".NEXTVAL INTO :new.entryIntegrationId FROM dual; END; / ALTER TRIGGER "BI_entryIntegration" ENABLE / |
c)SGBD IBM DB2
CREATE TABLE entryIntegration ( entryIntegrationId BIGINT NOT NULL GENERATED ALWAYS AS IDENTITY (START WITH +0 INCREMENT BY +1 MINVALUE +0 MAXVALUE +9223372036854775807 NO CYCLE NO CACHE NO ORDER )PRIMARY KEY, DOCUMENTDATA BLOB NOT NULL, STATUS INTEGER NOT NULL, KIND INTEGER NOT NULL); |
d) SGBD IBM INFORMIX
CREATE TABLE entryIntegration ( entryIntegrationId SERIAL8, DOCUMENTDATA BYTE NOT NULL, STATUS INTEGER NOT NULL, KIND INTEGER NOT NULL);
alter table entryIntegration modify lock mode (ROW); |
e) MySQL 5.1
CREATE TABLE `entryintegration` ( `entryIntegrationId` bigint(20) NOT NULL AUTO_INCREMENT, `documentdata` MEDIUMBLOB NOT NULL, `status` tinyint(4) NOT NULL, `kind` smallint(6) NOT NULL, PRIMARY KEY (`entryIntegrationId`), UNIQUE KEY `entryIntegrationId_UNIQUE` (`entryIntegrationId`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8 |