# API - Integração EDI

# API INTEGRAÇÃO EDI

[![image.png](http://conhecimento.olimpustecnologia.com.br/uploads/images/gallery/2025-05/scaled-1680-/ukrimage.png)](http://conhecimento.olimpustecnologia.com.br/uploads/images/gallery/2025-05/ukrimage.png)

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

---

<span style="white-space: pre-wrap;">📅 </span>**Atualizado em: 17/06/2024**  
<span style="white-space: pre-wrap;">🔗 </span>****URL Base:****<span style="white-space: pre-wrap;"> </span>[https://app.apicronos.com.br:5001/](https://app.apicronos.com.br:5001/)

---

#### <span style="white-space: pre-wrap;">🔐 </span>****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:****  
    `<span class="editor-theme-code">[POST] /api/v1/auth</span>`
- ****Parâmetros (Query):****
    - `<span class="editor-theme-code">client_id={your_client_id}</span>`
    - `<span class="editor-theme-code">secret_id={your_secret_id}</span>`
- ****Header obrigatório:****
    - `<span class="editor-theme-code">Authorization: Bearer {token}</span>`
    - <span style="white-space: pre-wrap;">Obs: O token tem validade de </span>****2 horas****<span style="white-space: pre-wrap;"> e deve ser enviado em todas as requisições subsequentes.</span>

---

#### <span style="white-space: pre-wrap;">📦 </span>****Recursos Disponíveis na API****

<span style="white-space: pre-wrap;">🔍 </span>****Consulta de Dados****

- ****Clientes****
    - `<span class="editor-theme-code">[GET] /api/v1/edi/cliente/{cpfcnpj}</span>`
    - Retorna dados do cliente já cadastrado.
- ****Cidades****
    - `<span class="editor-theme-code">[GET] /api/v1/edi/cidade/{nome}/{uf}</span>`
    - `<span class="editor-theme-code">[GET] /api/v1/edi/cidade/{codibge}</span>`
- ****Condições de Pagamento****
    - `<span class="editor-theme-code">[GET] /api/v1/edi/condicaopagto</span>`
    - `<span class="editor-theme-code">[GET] /api/v1/edi/condicaopagto/{codigo}</span>`
- ****Portadores****
    - `<span class="editor-theme-code">[GET] /api/v1/edi/portador</span>`
    - `<span class="editor-theme-code">[GET] /api/v1/edi/portador/{codigo}</span>`
- ****Produtos****
    - `<span class="editor-theme-code">[GET] /api/v1/edi/produto/{codigobarra}</span>`
    - `<span class="editor-theme-code">[GET] /api/v1/produto/{id}</span>`
    - `<span class="editor-theme-code">[GET] /api/v1/produto/grupo/{id}</span>`
    - `<span class="editor-theme-code">[GET] /api/v1/produto/</span>`<span style="white-space: pre-wrap;"> </span>**(retorna todos os produtos com estoque – ainda não paginado)**

---

#### <span style="white-space: pre-wrap;">📝 </span>****Cadastro de Novos Dados****

- ****Cliente****
    - `<span class="editor-theme-code">[POST] /api/v1/edi/cliente</span>`
    - <span style="white-space: pre-wrap;">Utilizado apenas se o cliente </span>****não estiver cadastrado****<span style="white-space: pre-wrap;"> no Cronos.</span>
- ****Pedido (Cabeçalho)****
    - `<span class="editor-theme-code">[POST] /api/v1/edi/pedido</span>`
- ****Itens do Pedido****
    - `<span class="editor-theme-code">[POST] /api/v1/edi/itempedido</span>`

<span style="white-space: pre-wrap;">🟡 </span>**Observação importante:**  
<span style="white-space: pre-wrap;">O campo </span>`<span class="editor-theme-code">codPed</span>`<span style="white-space: pre-wrap;"> deve seguir a estrutura: </span>`<span class="editor-theme-code">codfilialAAAAMMDDsequencial</span>`<span style="white-space: pre-wrap;">, por exemplo: </span>`<span class="editor-theme-code">9920231031999999</span>`.

---

#### <span style="white-space: pre-wrap;">📦 </span>****Consulta de Pedidos e NF-e****

- ****Status do Pedido****
    - `<span class="editor-theme-code">[GET] /api/v1/edi/pedido/status/{numpedido}</span>`
    - Retorna status, nota fiscal, chave da NF-e e status da venda.
- ****XML da NF-e****
    - `<span class="editor-theme-code">[GET] /api/v1/edi/pedido/xmlnfe/{idmov}</span>`

---

#### <span style="white-space: pre-wrap;">🏬 </span>****Filiais e Estoques****

- ****Lista de Filiais****
    - `<span class="editor-theme-code">[GET] /api/v1/edi/filiais</span>`
    - `<span class="editor-theme-code">[GET] /api/v1/edi/filiais/{codigo}</span>`
- ****Locais de Estoque****
    - `<span class="editor-theme-code">[GET] /api/v1/edi/localestoque</span>`
    - `<span class="editor-theme-code">[GET] /api/v1/edi/localestoque/{filial}</span>`