Manual para formação de arquivos Integrador

Importante:

•O tipo de arquivo abaixo poderá ser utilizado como envio da forma de pagamento para o integrador.

Para o correto funcionamento dos arquivos de Envio/Pagamento, deve-se utilizar o sufixo "_ped_env-pag" no nome de cada arquivo.

Por exemplo: LGSNDD2000001001#0001_ped_env-pag.txt

0000

PAI:

-

OBR.

1-1

Enviar pagamento para integrador - EnviarPagamento

#

Campo

Descrição

Tipo

Ob.

Tam.

Dec.

Observação

1

version

Versão do Arquivo

S

Utilizar version 1.00

2

tpOperacao

Tipo da operação

S

Deve ser preenchido com a descrição do tipo de operação (ENVIARPAGAMENTO)

Exemplo TXT:

0000;1.00;ENVIARPAGAMENTO

Exemplo XML:

<nfce version="1.00">

11000

PAI:

-

OBR.

1-1

Enviar pagamento para integrador - EnviarPagamento

#

Campo

Descrição

Tipo

Ob.

Tam.

Dec.

Observação

1

EnviarPagamento

Identificação da Operação

S

Exemplo TXT:

11000;

Exemplo XML:

<EnviarPagamento>

11100

PAI:

11000

OBR.

1-1

Enviar pagamento para integrador - EnviarPagamento

#

Campo

Descrição

Tipo

Ob.

Tam.

Dec.

Observação

1

chaveAcessoValidador

Código de identificação do Estabelecimento junto a SEFAZ e ao módulo do Validador fiscal, futuramente esta chave estará disponível no integrador fiscal

C

S

Exemplo TXT:

11100;25CFE38D-3B92-46C0-91CA-CFF751A82D3D

Exemplo XML:

<chaveAcessoValidador>25CFE38D-3B92-46C0-91CA-CFF751A82D3D</chaveAcessoValidador>

11101

PAI:

11000

OBR.

1-1

Enviar pagamento para integrador - EnviarPagamento

#

Campo

Descrição

Tipo

Ob.

Tam.

Dec.

Observação

1

idpagamento

NSU – Número Sequencial Único fornecido pela SEFAZ que deverá ser armazenado no PDV/AC para posterior consultas ao Validador Fiscal

C

S

Identificador do pagamento, poderá ser enviado mais de um grupo de pagamento no mesmo arquivo. O campo idpagamento, deverá ser utilizado dentro da tag Parametros.

2

Nome

Identificação do parâmetro

C

S

A tag Nome deverá pertencer a tag Parametro, que por sua vez pertence a tag Parametros. Vide tabela com a identificação com os parâmetros disponíveis.

Poderá ser enviado mais de um parâmetro para o mesmo grupo de pagamento.

3

Valor

C

S

A tag Valor deverá pertencer a tag Parametro, que por sua vez pertence a tag Parametros.

Poderá ser enviado mais de um parâmetro para o mesmo grupo de pagamento.

Exemplo TXT:

11101;pag001;Parametro - vide tabela;Valor - vide tabela de parametros

Exemplo XML:

<Parametros idpagamento="pag001">

<Parametro>

<Nome>Parametro - vide tabela</Nome>

<Valor>Valor - vide tabela de parametros</Valor>

</Parametro>

</Parametros>

Exemplo com mais de pagamento:

11101;pag001;Parametro - vide tabela;Valor - vide tabela de parametros

11101;pag002;Parametro - vide tabela;Valor - vide tabela de parametros

<Parametros idpagamento="pag001">

<Parametro>

<Nome>Parametro - vide tabela</Nome>

<Valor>Valor - vide tabela de parametros</Valor>

</Parametro>

</Parametros>

<Parametros idpagamento="pag002">

<Parametro>

<Nome>Parametro - vide tabela</Nome>

<Valor>Valor - vide tabela de parametros</Valor>

</Parametro>

</Parametros>

Parâmetros de Envio Pagamento Integrador

Parâmetro

Descrição

Tipo

Obr.

Valor Exemplo

ChaveRequisicao

Chave Guid que poderá ser gerada pela PDV/AC, esta chave deve identificar de forma única o CNPJ + Adquirente que irá processar o pagamento.

C

S

26359854-5698-1365-9856-965478231456

Estabelecimento

Código do Estabelecimento / MerchantID fornecido pela Adquirente contratada pelo Contribuinte.

C

S

10

SerialPos

Número Serial do POS que será utilizado para o envio do Valor de cobrança para o equipamento POS, deverá existir no PDV/AC um cadastro de POS para que seja selecionada na venda um determinado POS, ou para todos os POS, em casos de AC/PDV que não utilizam TEF pode ser vinculado a esse cadastro a CHAVEREQUISICAO

C

N

14034WL38205946

Cnpj

Número do CNPJ do Contribuinte.

C

S

12314564

IcmsBase

Deverá ser informado o valor da Base de Cálculo do ICMS, incluindo Base Isenta, Tributável e etc., em casos de serviços que não possuam base de ICMS não somar nesta TAG, vendas de produtos de recarga de celular, pagamento de contas, cartão vale presente que não estejam dentro de uma operação de venda com ICMS não deverá ser enviada essa informação a SEFAZ.

N

S

0.23

ValorTotalVenda

Deverá ser informado o valor da venda que será cobrado, este valor poderá ser somado a valores de serviços, gorjeta, recarga de celular, e etc.

N

S

1530,00

HabilitarMultiplosPagamentos

Este recurso será usado para definir se haverá múltiplos pagamentos no processo de pagamento, muito comum quando é pago em múltiplos

L

S

true

HabilitarControleAntiFraude

Este processo será usado para validação de possíveis fraudes no pagamento, verificando uma base histórica.

false ou true

L

S

false

CodigoMoeda

Informa a Moeda que será pago a venda.

Utilizar tabela ISO 4217

Real = BRL

C

S

BRL

EmitirCupomNFCE

Permitirá que o NFC-e seja emitido diretamente por equipamentos POS ou MPOS.

false ou true

L

S

false

OrigemPagamento

Esta informação servirá para que as informações apresentadas no equipamento de pagamento possa ser consultada em lista, permitindo assim uma maior flexibilidade no processo de pagamento e um maior controle ao cliente e aos contribuintes

C

S

Mesa 999

Importante:

•Este Arquivo, serve para consultar no Validador Fiscal de Pagamentos Eletrônicos se a sua solicitação de pagamento realizada anteriormente já foi processada pelo POS, caso afirmativo o Agente receberá os dados de pagamento, para realização da consulta é necessário que o Agente informe ao Validador Fiscal de Pagamentos Eletrônicos o número do IDPAGAMENTO recebido na solicitação de pagamento realizada no método “EnviarPagamento”.

•Para o correto funcionamento dos arquivos de Validador, deve-se utilizar o sufixo "_ped_sta-valid" no nome de cada arquivo.

Por exemplo: LGSNDD2000001001#0001_ped_sta-valid.txt

•Este arquivo é essencial para o correto funcionamento do processo offline do Integrador. Sem ele o processo offline não é Ativado.

0000

PAI:

-

OBR.

1-1

Validar Status Validador

#

Campo

Descrição

Tipo

Ob.

Tam.

Dec.

Observação

1

version

Versão do Arquivo

S

Utilizar version 1.00

2

tpOperacao

Tipo da operação

S

Deve ser preenchido com a descrição do tipo de operação (VERIFICARSTATUSVALIDADOR)

Exemplo TXT:

0000;1.00;VERIFICARSTATUSVALIDADOR

Exemplo XML:

<nfce version="1.00">

11000

PAI:

-

OBR.

1-1

Validar Status Validador

#

Campo

Descrição

Tipo

Ob.

Tam.

Dec.

Observação

1

VerificarStatusValidador

Identificação da Operação

S

Exemplo TXT:

11000;

Exemplo XML:

<VerificarStatusValidador>

11200

PAI:

11000

OBR.

1-1

Validar Status Validador

#

Campo

Descrição

Tipo

Ob.

Tam.

Dec.

Observação

1

chaveAcessoValidador

Código de identificação do Estabelecimento junto a SEFAZ e ao módulo do Validador fiscal, futuramente esta chave estará disponível no integrador fiscal

C

S

Exemplo TXT:

11200;25CFE38D-3B92-46C0-91CA-CFF751A82D3D

Exemplo XML:

<chaveAcessoValidador>25CFE38D-3B92-46C0-91CA-CFF751A82D3D</chaveAcessoValidador>

11201

PAI:

11200

OBR.

1-1

Validar Status Validador

#

Campo

Descrição

Tipo

Ob.

Tam.

Dec.

Observação

1

idpagamento

NSU – Número Sequencial Único fornecido pela SEFAZ que deverá ser armazenado no PDV/AC para posterior consultas ao Validador Fiscal

C

S

Identificador do pagamento, poderá ser enviado mais de um grupo de pagamento no mesmo arquivo. O campo idpagamento, deverá ser utilizado dentro da tag Parametros.

2

Nome

Identificação do parâmetro

C

S

A tag Nome deverá pertencer a tag Parametro, que por sua vez pertence a tag Parametros. Vide tabela com a identificação com os parâmetros disponíveis.

Poderá ser enviado mais de um parâmetro para o mesmo grupo de pagamento.

3

Valor

C

S

A tag Valor deverá pertencer a tag Parametro, que por sua vez pertence a tag Parametros.

Poderá ser enviado mais de um parâmetro para o mesmo grupo de pagamento.

Exemplo TXT:

11201;pag001;Parametro - vide tabela;Valor - vide tabela de parametros

Exemplo XML:

<Parametros idpagamento="pag001">

<Parametro>

<Nome>Parametro - vide tabela</Nome>

<Valor>Valor - vide tabela de parametros</Valor>

</Parametro>

</Parametros>

Exemplo com mais de pagamento:

11201;pag001;Parametro - vide tabela;Valor - vide tabela de parametros

11201;pag002;Parametro - vide tabela;Valor - vide tabela de parametros

<Parametros idpagamento="pag001">

<Parametro>

<Nome>Parametro - vide tabela</Nome>

<Valor>Valor - vide tabela de parametros</Valor>

</Parametro>

</Parametros>

<Parametros idpagamento="pag002">

<Parametro>

<Nome>Parametro - vide tabela</Nome>

<Valor>Valor - vide tabela de parametros</Valor>

</Parametro>

</Parametros>

Parâmetros de Envio Validar Status Validador

Parâmetro

Descrição

Tipo

Obr.

Valor Exemplo

idFila

NSU – Número Sequencial Único fornecido pela SEFAZ que foi retornado na solicitação do pagamento.

C

S

1698494

CNPJ

Número do CNPJ do Contribuinte.

C

S

12314564

Importante:

•Este Arquivo é utilizado para finalizar a operação comercial e informar ao Validador Fiscal de Pagamentos que um determinado pagamento já possui sua correspondência fiscal, ele também é utilizado para enviar o Extrato do CF-e ou Danfe para ser impresso no POS.

•Para o correto funcionamento dos arquivos de resposta fiscal, deve-se utilizar o sufixo "_ped_resp-fis" no nome de cada arquivo.

Por exemplo: LGSNDD2000001001#0001_ped_resp-fis.txt

0000

PAI:

-

OBR.

1-1

Resposta Fiscal

#

Campo

Descrição

Tipo

Ob.

Tam.

Dec.

Observação

1

version

Versão do Arquivo

S

Utilizar version 3.10

2

tpOperacao

Tipo da operação

S

Deve ser preenchido com a descrição do tipo de operação (RESPOSTAFISCAL)

Exemplo TXT:

0000;3.10;RESPOSTAFISCAL

Exemplo XML:

<nfce version="1.00">

11000

PAI:

-

OBR.

1-1

Resposta Fiscal

#

Campo

Descrição

Tipo

Ob.

Tam.

Dec.

Observação

1

RespostaFiscal

Identificação da Operação

S

Exemplo TXT:

11000;

Exemplo XML:

<RespostaFiscal>

11300

PAI:

11000

OBR.

1-1

Resposta Fiscal

#

Campo

Descrição

Tipo

Ob.

Tam.

Dec.

Observação

1

chaveAcessoValidador

Código de identificação do Estabelecimento junto a SEFAZ e ao módulo do Validador fiscal, futuramente esta chave estará disponível no integrador fiscal

C

S

Exemplo TXT:

11300;25CFE38D-3B92-46C0-91CA-CFF751A82D3D

Exemplo XML:

<chaveAcessoValidador>25CFE38D-3B92-46C0-91CA-CFF751A82D3D</chaveAcessoValidador>

11301

PAI:

11200

OBR.

1-1

Resposta Fiscal

#

Campo

Descrição

Tipo

Ob.

Tam.

Dec.

Observação

1

idpagamento

NSU – Número Sequencial Único fornecido pela SEFAZ que deverá ser armazenado no PDV/AC para posterior consultas ao Validador Fiscal

C

S

Identificador do pagamento, poderá ser enviado mais de um grupo de pagamento no mesmo arquivo. O campo idpagamento, deverá ser utilizado dentro da tag Parametros.

2

Nome

Identificação do parâmetro

C

S

A tag Nome deverá pertencer a tag Parametro, que por sua vez pertence a tag Parametros. Vide tabela com a identificação com os parâmetros disponíveis.

Poderá ser enviado mais de um parâmetro para o mesmo grupo de pagamento.

3

Valor

C

S

A tag Valor deverá pertencer a tag Parametro, que por sua vez pertence a tag Parametros.

Poderá ser enviado mais de um parâmetro para o mesmo grupo de pagamento.

Exemplo TXT:

11201;pag001;Parametro - vide tabela;Valor - vide tabela de parametros

Exemplo XML:

<Parametros idpagamento="pag001">

<Parametro>

<Nome>Parametro - vide tabela</Nome>

<Valor>Valor - vide tabela de parametros</Valor>

</Parametro>

</Parametros>

Exemplo com mais de um pagamento:

11201;pag001;Parametro - vide tabela;Valor - vide tabela de parametros

11201;pag002;Parametro - vide tabela;Valor - vide tabela de parametros

<Parametros idpagamento="pag001">

<Parametro>

<Nome>Parametro - vide tabela</Nome>

<Valor>Valor - vide tabela de parametros</Valor>

</Parametro>

</Parametros>

<Parametros idpagamento="pag002">

<Parametro>

<Nome>Parametro - vide tabela</Nome>

<Valor>Valor - vide tabela de parametros</Valor>

</Parametro>

</Parametros>

Parâmetros de Envio Validar Status Validador

Parâmetro

Descrição

Tipo

Obr.

Valor Exemplo

idFila

NSU – Número Sequencial Único fornecido pela SEFAZ foi retornado na solicitação do pagamento.

C

S

1698494

ChaveAcesso

Chave de Acesso do Documento Fiscal autorizado.

C

S

42150514200166000166654660000000291193267499

Nsu

Número Sequencial Único do pagamento fornecido pela adquirente.

C

S

1233244

NumerodeAprovacao

Código de Autorização do pagamento realizado e retornado pela Adquirente.

C

S

23424234

Bandeira

Tipo da Bandeira do cartão fornecido pela adquirente.

C

S

1

Adquirente

Adquirente que realizou a aprovação do pagamento.

C

S

1

CNPJ

Número do CNPJ do Contribuinte.

C

S

23424234

NumeroDocumento

Número do Documento Fiscal autorizado para Geração do QRCODE.

C

S

234