Enviar Produtos para Análise

Rota para recebimento de produtos do SISTEMA para análise tributária pela Nacional Tax.

Informações da Rota

Atributo	Valor
Método	POST
URL	/fiscal/enviar-produtos
Content-Type	application/json
Autenticação	Headers customizados
Limite	Máximo 1000 produtos por requisição

---

Headers de Autenticação

Todos as rotas requerem os seguintes headers para autenticação:

Header	Tipo	Obrigatório	Descrição
empresa-id	integer	Sim	ID da empresa na plataforma Nacional Tax
token-api	string	Sim	Token de autenticação do cliente
cnpj	string	Sim	CNPJ da empresa (apenas números)
regime-tributario	string	Sim	Regime tributário (SN, LP, LR)

---

Request Body

Estrutura Principal

{
  "operacao": "S",
  "consumidor_final": false,
  "natureza_operacao_id": 2,
  "destinatario": {
    "cnae": "4646002",
    "contrib_icms": true,
    "contrib_ipi": true,
    "regime_pis_cofins": 2,
    "regime_icms": 1,
    "uf": "SP"
  },
  "itens": [
    {
      "cprod": "PROD-001",
      "cean": "7891234567890",
      "xprod": "Água Mineral 500ml",
      "ncm": "22021000",
      "cest": "0301002",
      "vprod": 100.00,
      "picms": 18.00,
      "ppis": 2.32,
      "pcofins": 10.68,
      "icms_cst": "70",
      "csosn": null,
      "cst_pis": "02",
      "tipo_produto_id": "00",
      "fabricacao_id": 0,
      "cst_origem_id": 0,
      "cfop_id": "5102"
    }
  ]
}

Campos do Request

Nível Raiz

Campo	Tipo	Obrigatório	Descrição	Valores
operacao	string	Sim	Tipo de operação	E = Entrada S = Saída
consumidor_final	boolean	Sim	Venda para consumidor final	true / false
natureza_operacao_id	integer	Sim	ID da natureza de operação	Ver Tabela de Referência

Destinatário

Campo	Tipo	Obrigatório	Descrição
cnae	string	Sim	CNAE do destinatário (somente números)
contrib_icms	boolean	Sim	Contribuinte de ICMS
contrib_ipi	boolean	Sim	Contribuinte de IPI
regime_pis_cofins	integer	Sim	Regime PIS/COFINS: 1 = Cumulativo, 2 = Não-Cumulativo
regime_icms	integer	Sim	Regime ICMS: 1 = Normal, 2 = Simples Nacional
uf	string	Sim	UF do destinatário (2 caracteres)

Itens (Produtos)

Campo	Tipo	Obrigatório	Descrição
cprod	string	Sim	Código do produto no SISTEMA
cean	string	Sim	Código de barras EAN/GTIN
xprod	string	Sim	Descrição do produto
ncm	string	Não	NCM do produto no cliente
cest	string	Não	CEST do produto no cliente
vprod	decimal	Não	Valor unitário do produto
picms	decimal	Não	Alíquota ICMS (%)
ppis	decimal	Não	Alíquota PIS (%)
pcofins	decimal	Não	Alíquota COFINS (%)
icms_cst	string	Não	CST ICMS (2 caracteres)
csosn	integer	Não	CSOSN (Simples Nacional)
cst_pis	string	Não	CST PIS (2 caracteres)
tipo_produto_id	string	Sim	Ver Tabela de Referência
fabricacao_id	integer	Sim	0 = Própria, 1 = Terceiros
cst_origem_id	integer	Sim	Ver Tabela de Referência
cfop_id	string	Sim	CFOP da operação (4 dígitos)

---

Response

Sucesso (200 OK)

{
  "sucesso": True,
  "mensagem": "Revisão recebida com sucesso. Os produtos serão analisados.",
  "diagnostico_revisao_id": 12345,
  "total_produtos": 150,
  "client_id": 123
}

Erros Possíveis

400 Bad Request

Causa: Dados inválidos ou faltando campos obrigatórios

{
  "detail": [
    {
      "loc": ["body", "itens", 0, "cprod"],
      "msg": "field required",
      "type": "value_error.missing"
    }
  ]
}

401 Unauthorized

Causa: Headers de autenticação inválidos ou ausentes

{
  "detail": "Cliente não autorizado"
}

422 Unprocessable Entity

Causa: Limite de produtos excedido ou dados inconsistentes

{
  "detail": "Número máximo de produtos por revisão excedido. Limite: 1000"
}

500 Internal Server Error

Causa: Erro interno do servidor

{
  "detail": "Erro ao processar requisição. Contate o suporte."
}

Próximos Passos

Após enviar os produtos:

1. Aguardar Processamento:

   • Os produtos serão analisados

2. Consultar Produtos Revisados:

   • Use a rota Produtos Revisados
   • Produtos serão retornados com a tributação correta

3. Confirmar Recebimento:

   • Use a rota Confirmar Sincronização
   • Confirme o recebimento para liberar a próxima lista de produtos revisados