API - Integração EDI

• API INTEGRAÇÃO EDI

API INTEGRAÇÃO EDI

Manual de Integração – API EDI Cronos (v1)

---

📅 Atualizado em: 17/06/2024
🔗 URL Base: https://app.apicronos.com.br:5001/

---

🔐 Segurança e Autenticação

Antes de consumir qualquer endpoint da API, é necessário realizar o processo de autorização via OAuth:

🔄 Fluxo Authorization Code

• Endpoint de Autenticação:
  [POST] /api/v1/auth
• Parâmetros (Query):
  • client_id={your_client_id}
  • secret_id={your_secret_id}
• Header obrigatório:
  • Authorization: Bearer {token}
  • Obs: O token tem validade de 2 horas e deve ser enviado em todas as requisições subsequentes.

---

📦 Recursos Disponíveis na API

🔍 Consulta de Dados

• Clientes
  • [GET] /api/v1/edi/cliente/{cpfcnpj}
  • Retorna dados do cliente já cadastrado.
• Cidades
  • [GET] /api/v1/edi/cidade/{nome}/{uf}
  • [GET] /api/v1/edi/cidade/{codibge}
• Condições de Pagamento
  • [GET] /api/v1/edi/condicaopagto
  • [GET] /api/v1/edi/condicaopagto/{codigo}
• Portadores
  • [GET] /api/v1/edi/portador
  • [GET] /api/v1/edi/portador/{codigo}
• Produtos
  • [GET] /api/v1/edi/produto/{codigobarra}
  • [GET] /api/v1/produto/{id}
  • [GET] /api/v1/produto/grupo/{id}
  • [GET] /api/v1/produto/ (retorna todos os produtos com estoque – ainda não paginado)

---

📝 Cadastro de Novos Dados

• Cliente
  • [POST] /api/v1/edi/cliente
  • Utilizado apenas se o cliente não estiver cadastrado no Cronos.
• Pedido (Cabeçalho)
  • [POST] /api/v1/edi/pedido
• Itens do Pedido
  • [POST] /api/v1/edi/itempedido

🟡 Observação importante:
O campo codPed deve seguir a estrutura: codfilialAAAAMMDDsequencial, por exemplo: 9920231031999999.

---

📦 Consulta de Pedidos e NF-e

• Status do Pedido
  • [GET] /api/v1/edi/pedido/status/{numpedido}
  • Retorna status, nota fiscal, chave da NF-e e status da venda.
• XML da NF-e
  • [GET] /api/v1/edi/pedido/xmlnfe/{idmov}

---

🏬 Filiais e Estoques

• Lista de Filiais
  • [GET] /api/v1/edi/filiais
  • [GET] /api/v1/edi/filiais/{codigo}
• Locais de Estoque
  • [GET] /api/v1/edi/localestoque
  • [GET] /api/v1/edi/localestoque/{filial}