API de Cenário Fiscal

Bem-vindo à documentação técnica da Nacional Tax - sua solução completa para análise e classificação fiscal.

---

Nossa API permite que seu sistema:

1. Envie produtos para análise tributária
2. Receba classificação fiscal completa, incluindo os campos da Reforma Tributária.
3. Sincronize automaticamente produtos revisados
4. Garanta conformidade em todas as operações

---

Fluxo de Integração

Etapas do Fluxo

1. Envio: SISTEMA envia produtos para análise
2. Processamento: Classificação de produtos
3. Consulta: SISTEMA busca produtos já classificados
4. Confirmação: SISTEMA confirma recebimento dos produtos
5. Novo Lote: API disponibiliza próxima lista de produtos após confirmação

---

Rotas Base

Recurso	Link
Portal Web	web.nacionaltax.com.br
API Produção	https://gw.nacionaltax.com.br/api/v1
API Homologação	https://gwhml.nacionaltax.com.br/api/v1

---

Rotas API

Endpoint	Método	Descrição
/fiscal/enviar-produtos	POST	Envia produtos para análise
/fiscal/produtos-revisados	POST	Busca produtos já classificados
/fiscal/confirmar-sincronizacao	POST	Confirma recebimento dos produtos analisados

---

Começando

Passo 1: Obter Credenciais

Acesse nosso portal web e cadastre o seu cliente. O portal irá disponibilizar as credenciais:

• empresa-id - Identificador único da sua empresa
• token-api - Token de autenticação

Passo 2: Configurar Autenticação

Nossa API usa autenticação via headers customizados:

curl -X POST https://gw.nacionaltax.com.br/api/v1/fiscal/enviar-produtos \
  -H "empresa-id: 12345" \
  -H "token-api: seu-token-aqui" \
  -H "cnpj: 12345678000190" \
  -H "regime-tributario: LR" \
  -H "Content-Type: application/json"

Passo 3: Fazer Primeira Requisição

Exemplo básico de envio de produto:

  {
    "operacao": "S",
    "consumidor_final": true,
    "natureza_operacao_id": 2,
    "destinatario": {
      "cnae": "3333333",
      "contrib_icms": true,
      "contrib_ipi": true,
      "regime_icms": 1,
      "regime_pis_cofins": 2,
      "uf": "SP"
    },
    "itens": [
      {
        "cprod": "PROD001",
        "cean": "7891234567890",
        "cst_origem_id": 0,
        "fabricacao_id": 1,
        "tipo_produto_id": "00"
      }
    ]
  }

Suporte

Canais de Atendimento

• Whatsapp: (34) 99999-9999

---