Integrar com uma API fiscal n\u00e3o precisa ser complicado.
Se voc\u00ea \u00e9 desenvolvedor, CTO ou apenas algu\u00e9m que quer entender como funciona a emiss\u00e3o de NFS-e por API, este guia foi feito para voc\u00ea.<\/p>\n
Aqui, voc\u00ea vai passar por todo o fluxo essencial:<\/p>\n
Tudo isso em poucos minutos<\/strong>.<\/p>\n Antes de come\u00e7ar, voc\u00ea s\u00f3 precisa ter:<\/p>\n Com isso pronto, voc\u00ea j\u00e1 consegue integrar sem complica\u00e7\u00e3o.<\/p>\n A API Key \u00e9 a credencial que identifica sua aplica\u00e7\u00e3o na NFE.io.<\/p>\n Siga os passos:<\/p>\n No terminal, execute:<\/p>\n curl -X GET “https:\/\/api.nfe.io\/v1\/companies” \\ Se recebeu o status 200, voc\u00ea j\u00e1 pode emitir sua primeira nota.<\/p>\n Para facilitar, aqui est\u00e1 um exemplo completo e funcional:<\/p>\n curl -X POST “https:\/\/api.nfe.io\/v1\/nfse\/SEU_ID_DA_EMPRESA” \\ { Algumas observa\u00e7\u00f5es:<\/p>\n1. Pr\u00e9-requisitos\u00a0<\/strong><\/h2>\n
\n
curl<\/code> ou Node.js<\/strong> instalado<\/li>\n<\/ul>\n2. Gerando sua API Key\u00a0<\/strong><\/h2>\n
\n
3. Teste r\u00e1pido: verifique se sua API Key funciona<\/strong><\/h2>\n
\n-H “Authorization: ApiKey SUA_API_KEY_AQUI”<\/p>\nPoss\u00edveis resultados:<\/h3>\n
\n
4. Emitindo sua primeira NFS-e (4\u20135 minutos)<\/strong><\/h2>\n
Payload m\u00ednimo recomendado<\/strong><\/h3>\n
\n“cityServiceCode”: “101”,
\n“description”: “Consultoria em tecnologia”,
\n“servicesAmount”: 150,
\n“borrower”: {
\n“federalTaxNumber”: “12345678909”,
\n“name”: “Cliente Exemplo”,
\n“email”: “cliente@example.com”,
\n“address”: {
\n“country”: “BRA”,
\n“postalCode”: “01311000”,
\n“street”: “Av Paulista”,
\n“number”: “1000”,
\n“district”: “Bela Vista”,
\n“city”: “S\u00e3o Paulo”,
\n“state”: “SP”
\n}
\n}
\n}<\/div>\n<\/div>\nChamando o endpoint via cURL<\/h3>\n
\n-H “Content-Type: application\/json” \\
\n-H “Authorization: ApiKey SUA_API_KEY_AQUI” \\
\n-d ‘{
\n“cityServiceCode”: “101”,
\n“description”: “Consultoria em tecnologia”,
\n“servicesAmount”: 150,
\n“borrower”: {
\n“federalTaxNumber”: “12345678909”,
\n“name”: “Cliente Exemplo”,
\n“email”: “cliente@example.com”,
\n“address”: {
\n“country”: “BRA”,
\n“postalCode”: “01311000”,
\n“street”: “Av Paulista”,
\n“number”: “1000”,
\n“district”: “Bela Vista”,
\n“city”: “S\u00e3o Paulo”,
\n“state”: “SP”
\n}
\n}
\n}’<\/p>\n5. Entendendo o retorno da API<\/h3>\n
\n“id”: “123456”,
\n“status”: “processing”,
\n“companyId”: “SEU_ID_DA_EMPRESA”,
\n“servicesAmount”: 150,
\n“borrower”: {
\n“federalTaxNumber”: “12345678909”,
\n“name”: “Cliente Exemplo”
\n}
\n}<\/p>\n