{"info":{"name":"Fiscal Pro — Integração entre sistemas","schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json","description":"Configure as variáveis localmente. client_secret e access_token devem ser secretos. Antes de executar criações, confirme empresa, ambiente fiscal e modo rascunho/transmissão no Fiscal Pro. Os exemplos não são dados de produção."},"variable":[{"key":"base_url","value":"https://api.fiscalpro.com.br","type":"string"},{"key":"client_id","value":"","type":"string"},{"key":"client_secret","value":"","type":"string"},{"key":"access_token","value":"","type":"string"},{"key":"cpf_cnpj","value":"","type":"string"},{"key":"id_operacao","value":"","type":"string"},{"key":"idempotency_key","value":"pedido-erp-0001","type":"string"}],"item":[{"name":"Autenticação","item":[{"name":"Obter token de acesso","request":{"method":"POST","description":"Autentique sua aplicação com OAuth 2.0 Client Credentials. O token dura 3600 segundos (1 hora). Reutilize-o no backend até perto da expiração e renove usando as mesmas credenciais; este fluxo não usa refresh token.\n\nUse application/x-www-form-urlencoded. O servidor também aceita client_id e client_secret via HTTP Basic.\n\nCadastre e revogue credenciais no aplicativo. Este portal não solicita nem armazena seus segredos.","auth":{"type":"noauth"},"header":[],"url":"{{base_url}}/integracao/oauth/token","body":{"mode":"urlencoded","urlencoded":[{"key":"grant_type","value":"client_credentials"},{"key":"client_id","value":"{{client_id}}"},{"key":"client_secret","value":"{{client_secret}}"}]}}}]},{"name":"Cadastros","item":[{"name":"Sincronizar pessoa","request":{"method":"PUT","description":"Crie ou atualize os dados cadastrais do cliente/tomador. O documento numérico válido vai no caminho. Inscrições e indicadores fiscais existentes são preservados.\n\n201 para cadastro novo; 200 para atualização. Novas pessoas são cadastradas como não contribuintes; revise os dados fiscais no Fiscal Pro quando necessário.\n\nNão envie inscrição estadual, municipal ou indicadores fiscais neste corpo.","auth":{"type":"bearer","bearer":[{"key":"token","value":"{{access_token}}","type":"string"}]},"header":[{"key":"Content-Type","value":"application/json"}],"url":"{{base_url}}/integracao/v1/pessoas/{{cpf_cnpj}}","body":{"mode":"raw","raw":"{\n  \"razao_social\": \"Cliente de exemplo\",\n  \"email\": \"cliente@example.com\",\n  \"endereco\": {\n    \"cep\": \"01001000\",\n    \"logradouro\": \"Praça de exemplo\",\n    \"numero\": \"100\",\n    \"bairro\": \"Centro\",\n    \"codigo_municipio\": 3550308\n  }\n}","options":{"raw":{"language":"json"}}}}},{"name":"Listar serviços","request":{"method":"GET","description":"Consulte os serviços da empresa e use id_servico para preparar a NFS-e. Confira o indicador ativo e a configuração do serviço no Fiscal Pro.","auth":{"type":"bearer","bearer":[{"key":"token","value":"{{access_token}}","type":"string"}]},"header":[],"url":"{{base_url}}/integracao/v1/servicos"}},{"name":"Listar produtos","request":{"method":"GET","description":"Consulte produtos cadastrados para NF-e e NFC-e. A API permite leitura do catálogo; a manutenção fiscal dos produtos acontece no Fiscal Pro.\n\nEnquanto houver proximo_id, use esse valor como apos_id na próxima chamada. IDs de produtos são específicos da empresa autenticada.","auth":{"type":"bearer","bearer":[{"key":"token","value":"{{access_token}}","type":"string"}]},"header":[],"url":"{{base_url}}/integracao/v1/produtos?apos_id=0&limite=50"}}]},{"name":"NF-e","item":[{"name":"Criar NF-e","request":{"method":"POST","description":"Envie os dados comerciais. A configuração da aplicação determina rascunho ou transmissão automática; empresa, ambiente, numeração e parâmetros fiscais vêm do Fiscal Pro.\n\nDe 1 a 250 itens e de 1 a 20 pagamentos. valor é unitário; desconto é o desconto total daquele item. Decimais são strings.\n\nOs valores são ilustrativos: pagamentos devem corresponder ao total efetivamente calculado, inclusive acréscimos tributários. Use IDs reais da sua empresa.\n\nInforme destinacao e presenca. Frete e entrega são opcionais; a entrega não altera o cadastro do cliente. Cartão exige dados reais quando aplicáveis.","auth":{"type":"bearer","bearer":[{"key":"token","value":"{{access_token}}","type":"string"}]},"header":[{"key":"Idempotency-Key","value":"{{idempotency_key}}"},{"key":"Content-Type","value":"application/json"}],"url":"{{base_url}}/integracao/v1/nfe","body":{"mode":"raw","raw":"{\n  \"cpf_cnpj\": \"52998224725\",\n  \"destinacao\": \"consumo_final\",\n  \"presenca\": \"internet\",\n  \"itens\": [\n    {\n      \"id_produto\": 1,\n      \"quantidade\": \"1\",\n      \"valor\": \"10.00\"\n    }\n  ],\n  \"pagamentos\": [\n    {\n      \"meio\": \"01\",\n      \"valor\": \"10.00\",\n      \"a_prazo\": false\n    }\n  ]\n}","options":{"raw":{"language":"json"}}}}},{"name":"Consultar NF-e","request":{"method":"GET","description":"Consulte pelo id_operacao retornado na criação, usando a mesma aplicação. A consulta de uma pendência pode atualizar o resultado fiscal sem retransmitir o documento.\n\nRespeite proxima_consulta_em quando informado. Se requer_acao_manual for true, acompanhe a operação no Fiscal Pro; não crie outra venda.","auth":{"type":"bearer","bearer":[{"key":"token","value":"{{access_token}}","type":"string"}]},"header":[],"url":"{{base_url}}/integracao/v1/nfe/{{id_operacao}}"}},{"name":"Baixar XML da NF-e","request":{"method":"GET","description":"Receba o arquivo binário autenticado, vinculado à empresa e à aplicação. Disponível para operação autorizada ou cancelada, quando o arquivo existir. Confira os indicadores de disponibilidade na consulta.\n\n404 pode indicar operação inacessível ou arquivo ainda indisponível. Consulte a operação e tente o download mais tarde, sem repetir a emissão.","auth":{"type":"bearer","bearer":[{"key":"token","value":"{{access_token}}","type":"string"}]},"header":[],"url":"{{base_url}}/integracao/v1/nfe/{{id_operacao}}/xml"}},{"name":"Baixar PDF da NF-e","request":{"method":"GET","description":"Receba o arquivo binário autenticado, vinculado à empresa e à aplicação. Disponível para operação autorizada ou cancelada, quando o arquivo existir. Confira os indicadores de disponibilidade na consulta.\n\n404 pode indicar operação inacessível ou arquivo ainda indisponível. Consulte a operação e tente o download mais tarde, sem repetir a emissão.","auth":{"type":"bearer","bearer":[{"key":"token","value":"{{access_token}}","type":"string"}]},"header":[],"url":"{{base_url}}/integracao/v1/nfe/{{id_operacao}}/pdf"}}]},{"name":"NFC-e","item":[{"name":"Criar NFC-e","request":{"method":"POST","description":"Envie os dados comerciais. A configuração da aplicação determina rascunho ou transmissão automática; empresa, ambiente, numeração e parâmetros fiscais vêm do Fiscal Pro.\n\nDe 1 a 250 itens e de 1 a 20 pagamentos. valor é unitário; desconto é o desconto total daquele item. Decimais são strings.\n\nOs valores são ilustrativos: pagamentos devem corresponder ao total efetivamente calculado, inclusive acréscimos tributários. Use IDs reais da sua empresa.\n\nVenda presencial para consumo final. Sem frete/entrega. CPF pode ser omitido quando a identificação for dispensável; para CNPJ, use NF-e. A autorização depende das validações do emissor.","auth":{"type":"bearer","bearer":[{"key":"token","value":"{{access_token}}","type":"string"}]},"header":[{"key":"Idempotency-Key","value":"{{idempotency_key}}"},{"key":"Content-Type","value":"application/json"}],"url":"{{base_url}}/integracao/v1/nfce","body":{"mode":"raw","raw":"{\n  \"itens\": [\n    {\n      \"id_produto\": 1,\n      \"quantidade\": \"1\",\n      \"valor\": \"10.00\"\n    }\n  ],\n  \"pagamentos\": [\n    {\n      \"meio\": \"01\",\n      \"valor\": \"10.00\",\n      \"a_prazo\": false\n    }\n  ]\n}","options":{"raw":{"language":"json"}}}}},{"name":"Consultar NFC-e","request":{"method":"GET","description":"Consulte pelo id_operacao retornado na criação, usando a mesma aplicação. A consulta de uma pendência pode atualizar o resultado fiscal sem retransmitir o documento.\n\nRespeite proxima_consulta_em quando informado. Se requer_acao_manual for true, acompanhe a operação no Fiscal Pro; não crie outra venda.","auth":{"type":"bearer","bearer":[{"key":"token","value":"{{access_token}}","type":"string"}]},"header":[],"url":"{{base_url}}/integracao/v1/nfce/{{id_operacao}}"}},{"name":"Baixar XML da NFC-e","request":{"method":"GET","description":"Receba o arquivo binário autenticado, vinculado à empresa e à aplicação. Disponível para operação autorizada ou cancelada, quando o arquivo existir. Confira os indicadores de disponibilidade na consulta.\n\n404 pode indicar operação inacessível ou arquivo ainda indisponível. Consulte a operação e tente o download mais tarde, sem repetir a emissão.","auth":{"type":"bearer","bearer":[{"key":"token","value":"{{access_token}}","type":"string"}]},"header":[],"url":"{{base_url}}/integracao/v1/nfce/{{id_operacao}}/xml"}},{"name":"Baixar PDF da NFC-e","request":{"method":"GET","description":"Receba o arquivo binário autenticado, vinculado à empresa e à aplicação. Disponível para operação autorizada ou cancelada, quando o arquivo existir. Confira os indicadores de disponibilidade na consulta.\n\n404 pode indicar operação inacessível ou arquivo ainda indisponível. Consulte a operação e tente o download mais tarde, sem repetir a emissão.","auth":{"type":"bearer","bearer":[{"key":"token","value":"{{access_token}}","type":"string"}]},"header":[],"url":"{{base_url}}/integracao/v1/nfce/{{id_operacao}}/pdf"}}]},{"name":"NFS-e","item":[{"name":"Criar NFS-e","request":{"method":"POST","description":"Envie os dados comerciais. A configuração da aplicação determina rascunho ou transmissão automática; empresa, ambiente, numeração e parâmetros fiscais vêm do Fiscal Pro.\n\nDe 1 a 50 itens. O tomador deve estar sincronizado e os serviços configurados. Não envie tributos, município, série ou ambiente no payload.\n\nO contrato comercial da integração não representa todos os campos da emissão manual. Confira a aplicabilidade dos cadastros antes de transmitir.","auth":{"type":"bearer","bearer":[{"key":"token","value":"{{access_token}}","type":"string"}]},"header":[{"key":"Idempotency-Key","value":"{{idempotency_key}}"},{"key":"Content-Type","value":"application/json"}],"url":"{{base_url}}/integracao/v1/nfse","body":{"mode":"raw","raw":"{\n  \"cpf_cnpj\": \"52998224725\",\n  \"itens\": [\n    {\n      \"id_servico\": 1,\n      \"quantidade\": \"1\",\n      \"valor\": \"100.00\"\n    }\n  ]\n}","options":{"raw":{"language":"json"}}}}},{"name":"Consultar NFS-e","request":{"method":"GET","description":"Consulte pelo id_operacao retornado na criação, usando a mesma aplicação. A consulta de uma pendência pode atualizar o resultado fiscal sem retransmitir o documento.\n\nNFS-e possui resposta própria: numero é texto e id_nfse é o ID interno. Não presuma os campos xml_disponivel e pdf_disponivel de NF-e/NFC-e.","auth":{"type":"bearer","bearer":[{"key":"token","value":"{{access_token}}","type":"string"}]},"header":[],"url":"{{base_url}}/integracao/v1/nfse/{{id_operacao}}"}},{"name":"Baixar PDF da NFS-e","request":{"method":"GET","description":"Receba o arquivo binário autenticado, vinculado à empresa e à aplicação. O PDF exige NFS-e autorizada; arquivo ainda indisponível retorna 404.\n\n404 pode indicar operação inacessível ou arquivo ainda indisponível. Consulte a operação e tente o download mais tarde, sem repetir a emissão.\n\nA API de integração não oferece uma rota de XML de NFS-e nesta versão.","auth":{"type":"bearer","bearer":[{"key":"token","value":"{{access_token}}","type":"string"}]},"header":[],"url":"{{base_url}}/integracao/v1/nfse/{{id_operacao}}/pdf"}}]}]}