- Informações Técnicas
- Rafael Ramos Schmitz
Essa página tem como objetivo documentar informações técnicas sobre a integração online.
Inclusões/Alterações:
A0000 - CADASTRO DE SERIES
destination.serie.save
M0000 - Cadastro de Mercadoria
destination.mercadoria.save
M2000 - GRUPO DE MERCADORIA/SERVIÇO
destination.grupo.save
M3000 - GRUPO INVENTARIO
destination.grupoinv.save
M4000 - Cadastro de Serviços
destination.servico.save
P0000 - Cadastro de Pessoa
destination.pessoa.save
T0000 - TIPO CREDITO PIS/COFINS
destination.cfgtpcred.save
U0000 - UNIDADE DE MEDIDA
destination.unidade.save
00400 - Cadastro Natureza de Operação
destination.natoperacao.save
D0000 - OUTROS DEBITOS/CREDITOS
destination.odc.save
E0000 - Entradas
destination.entrada.save
F0000 - Prestação de Serviço
destination.prest.save
G0000 - Documento Fiscal Emitido por ECF
destination.ecf.save
I0000 - Impostos Retidos
destination.impostoretido.save
O0000 - Outras Operações PIS/COFINS
destination.F100.save
R0000 - Cabeçalho do Mapa Resumo
destination.mapa.save
S0000 - Saídas
destination.saida.save
H0000 - Inventário
destination.inventario.save
K0100 - Controle de Produção e Estoque
destination.K100.save
00100 - Processos Administrativos e Judiciais
destination.procjud.save
00200 - SCANC Tipo 60
destination.scanc60.save
01100 - Exportação - Registro de Informações
destination.exportacoes.save
01300 - Combustíveis - Movimentação de Tanques
destination.movcomb.save
01350 - Bombas
destination.bomba.save
01600 - Movimentações de Cartão de Crédito(Até 31/12/2021)
destination.movcartao.save
01601-Operações com Instrumentos de pagto eletrônico
destination.pageletronico.save
Json:
Validação:
rfc 8259
Informações Importantes:
Não é necessário utilizar a fila de exclusão para integrações, o serviço de cada fila é responsável por identificar se a nota já existe dentro do fiscal e realizar a sua alteração. Porém, o que controla isso é o campo IDORIGEM de cada documento então se a mesma nota teve seu IDORIGEM alterado por qualquer motivo, então deve ser utilizada a fila para deletar a nota antiga.
Informações importantes sobre os campos do tipo caractere: sempre deve ser entre aspas duplas “VALOR TEXTO“. Podem aceitar a informação null, e também podem ser desconsiderados do JSON caso o campo em questão não seja obrigatório e não tenha valor.
Informações importantes sobre os campos do tipo numérico: não devem conter aspas duplas, não utilizam separador de milhar e casas decimais são separadas por ponto. Podem aceitar a informação null, e também podem ser desconsiderados do JSON caso o campo em questão não seja obrigatório e não tenha valor.
Arquivos JSON que tem filhos no formato de array, quando não houver informação de filho deve ser montado como array vazio e não como null.
Exemplo:
JSON somente com o cabeçalho de outros débitos e créditos, repare que a paridade “fodcvals” está utilizando colchetes para identificar o array vazio [].
Outro exemplo seria não mandar a paridade "fodcvals", também é um modelo que não está em conformidade com o layout necessário.
Certo:
{
"estab": 1001,
"idimposto": "ICMS",
"data": "15/09/2001",
"uf": null,
"idorigem": "ODC|1001|ICMS|150921|",
"fodcvals": []
}
Errado:
{
"estab":1001,
"idimposto":"ICMS",
"data":"15/09/2001",
"uf":null,
"idorigem":"ODC|1001|ICMS|150921|",
"fodcvals": null
}
{
"estab":1001,
"idimposto":"ICMS",
"data":"15/09/2001",
"uf":null,
"idorigem":"ODC|1001|ICMS|150921|"
}
Delete:
D0000 - OUTROS DEBITOS/CREDITOS
destination.odc.delete
E0000 - Entradas
destination.entrada.delete
F0000 - Prestação de Serviço
destination.prest.delete
G0000 - Documento Fiscal Emitido por ECF
destination.ecf.delete
I0000 - Impostos Retidos
destination.impostoretido.delete
O0000 - Outras Operações PIS/COFINS
destination.F100.delete
R0000 - Cabeçalho do Mapa Resumo
destination.mapa.delete
S0000 - Saídas
destination.saida.delete
H0000 - Inventário
destination.inventario.delete
K0100 - Controle de Produção e Estoque
destination.K100.delete
00100 - Processos Administrativos e Judiciais
destination.procjud.delete
00200 - SCANC Tipo 60
destination.scanc60.delete
01100 - Exportação - Registro de Informações
destination.exportacoes.delete
01300 - Combustíveis - Movimentação de Tanques
destination.movcomb.delete
01350 - Bombas
destination.bomba.delete
01600 - Movimentações de Cartão de Crédito(Até 31/12/2021)
destination.movcartao.delete
01601-Operações com Instrumentos de pagto eletrônico
destination.pageletronico.delete
Json
Validação:
rfc 8259
Exemplo:
{ “idorigem“: “0001|NOTA|78|4589“ }
Informações Importantes:
Consiste em um JSON simples somente com a informação do IDORIGEM.
A diferenciação de qual será o tipo do documento a ser excluído será feita pela fila que o JSON será enviado.
Por exemplo se eu enviar para destination.entrada.delete o JSON exemplo a nota de entrada com IDORIGEM 0001|NOTA|78|4589 será excluída. Mas se enviar o JSON para destination.saida.delete o serviço tentará identificar se existe uma nota de saída com esse IDORIGEM.