Dúvidas Frequentes e Outras Especificações

Vamos responder as principais duvidas que surgem entre aqueles que integram conosco.

1) Quais as tecnologias usadas pela InvoiSys Sistemas?

a) REST API O REST API é um estilo arquitetural que utilizamos para comunicar duas aplicações distintas (neste caso, a solução do integrador e a InvoiSys). A idéia é utilizar de maneira mais eficiente e em sua plenitude as características do protocolo HTTP, principalmente no que diz respeito à semântica do protocolo.

O resultado disso ao final das contas é, além da utilização mais “correta” do protocolo, um trânsito de informações mais eficiente e, por consequência, mais rápido.

b) JSON O JSON (JavaScript Object Notation) é uma forma bem leve de representação e troca de informações.

Ele tem a única função de levar informações de um lado para o outro. Nós podemos utilizar o JSON para transportar informações entre mensagens HTTP.

c) HTTP Ele é um protocolo cliente-servidor que se caracteriza por uma conexão feita entre uma máquina cliente e uma máquina servidora, geralmente de forma assíncrono.

O resultado desta comunicação são as mensagens HTTP, e todas estas informações podem ser acesadas como se fossem um endereço web.

2) Quais são os tipos de Origem de Mercadoria?

• 0 - Nacional, exceto as indicadas nos códigos 3, 4, 5 e 8;

• 1 - Estrangeira - Importação direta, exceto a indicada no código 6;

• 2 - Estrangeira - Adquirida no mercado interno, exceto a indicada no código 7;

• 3 - Nacional, mercadoria ou bem com Conteúdo de Importação superior a 40% e inferior ou igual a 70%;

• 4 - Nacional, cuja produção tenha sido feita em conformidade com os processos produtivos básicos de que tratam as legislações citadas nos Ajustes;

• 5 - Nacional, mercadoria ou bem com Conteúdo de Importação inferior ou igual a 40%;

• 6 - Estrangeira - Importação direta, sem similar nacional, constante em lista da CAMEX e gás natural;

• 7 - Estrangeira - Adquirida no mercado interno, sem similar nacional, constante lista CAMEX e gás natural.

• 8 - Nacional, mercadoria ou bem com Conteúdo de Importação superior a 70%;

3) Como enviar o campo Módulos Habilitados, no cadastro da empresa via API?

Ao realizar o cadastro de uma empresa na plataforma Invoisys, deve-se indicar qual módulo a empresa estará habilitada em nosso sistema (NF-e, NFC-e, NFS-e, etc). No layout do JSON para cadastro via API, utiliza-se o campo "modulosHabilitados": 0, que funciona da seguinte forma:

Nenhum = 0, NFe = 1, NFCe = 2, NFSe = 4, CFe = 8, NFeEntrada = 16, CTe = 32

Caso, deseje habilitar mais de 1 módulo, o valor será a soma dos valores de ambos. Exemplo, a Invoisys utiliza "39" e possui todos os módulos habilitados. o Valor é "39" pois nfe(1) + nfce(2) + nfs(4) + cte(32) = 39

3) Tratamento dos Response Code.

Os códigos retornados nas requisições comas nossas APIs, são os especificados através do padrão mundial de comunicação HTTP. Para identificar os códigos e mapeá-los, confira o artigo na íntegra: https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html