Dúvidas Frequentes e Outras Especificações
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.
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%;
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
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