# Manual de Implantação – Integração ILLI + F360 Finanças (via Webhook)

##### Visão Geral

A integração entre o sistema **ILLI** e o **F360 Finanças** permite automatizar o envio de dados financeiros, centralizando informações como:

- Cupons fiscais (vendas)
- Títulos de contas a pagar e receber  
    Tudo isso via Webhooks — notificações em tempo real enviadas via HTTP.

---


#####  

##### **1. Pré-Requisitos para Início**

Antes de configurar a integração:

- Solicite ao time do F360 o **identificador único do serviço** e a **URL base** do webhook.
- Garanta que o **CNPJ da loja** esteja cadastrado corretamente no F360.
- Consulte a [documentação técnica do F360](https://kb.illimitar.pro/link/891#bkmrk-desenvolvedores%3A-mau) para endpoints de centros de custo e planos de contas.

---

##### **2. Endpoints Padrão**

**Formato da URL:**

```
https://webhook.f360.com.br/{identificador-unico-do-servico}/{servico-consumido}
```

- `identificador-unico-do-servico`: gerado pelo F360 e fornecido à empresa.
- `servico-consumido`: indica o tipo de informação a ser enviada. Exemplos:
    
    
    - `f360-cupom-fiscal`
    - `f360-{id}-titulo`

---

#####  

##### **3. Envio de Cupons Fiscais**

Use o endpoint `f360-cupom-fiscal` para enviar registros de venda.

**Requisição:**

- Método: `POST`
- Content-Type: `application/json`
- Envio assíncrono (o status do processamento deve ser consultado no próprio F360)

**Exemplo de JSON simplificado:**

```
{
  "NomeSistema": "ILLI",
  "Values": [
    {
      "NumeroCupom": "100001",
      "CNPJEmitente": "12345678000100",
      "Cliente": {
        "Nome": "Maria Oliveira",
        "Cpf": "12345678900"
      },
      "MeioPagamento": [
        {
          "FormaPagamento": "PIX",
          "Valor": 120.50,
          "QtdParcelas": "1",
          "Vencimento": "2025-06-01T14:30:00"
        }
      ],
      "Data": "2025-06-01T14:30:00"
    }
  ]
}

```

**Campos obrigatórios**:

- `NumeroCupom`, `CNPJEmitente`, `Data`, `MeioPagamento`, `FormaPagamento`, `Valor`

**Observações:**

- Cupons com o mesmo número devem ser enviados uma única vez.
- Cada request deve conter cupons de **um único CNPJ** e **dia específico**.

---

##### **4. Envio de Títulos (Contas a Pagar e Receber)**

Use o endpoint `f360-{id}-titulos` para enviar registros financeiros.

**Requisição:**

- Método: `POST`
- Content-Type: `application/json`
- Operação exclusiva para inclusão de novos registros

**Exemplo de JSON simplificado:**

```
{
  "titulos": [
    {
      "cnpj": "12345678000100",
      "tipoTitulo": "receber",
      "numeroTitulo": "A00123",
      "clienteFornecedor": "João da Silva",
      "detalhesClienteFornecedor": {
        "nome": "João da Silva",
        "cpfCnpj": "12345678900"
      },
      "emissao": "2025-06-01",
      "valor": 200.00,
      "tipoDocumento": "boleto",
      "contaBancaria": "Conta Banco XYZ",
      "meioPagamento": "boleto",
      "parcelas": [
        {
          "vencimento": "2025-06-30",
          "valor": 200.00,
          "numeroParcela": 1
        }
      ],
      "rateio": [
        {
          "competencia": "06-2025",
          "centroDeCusto": "Operacional",
          "planoDeContas": "Receitas",
          "numeroParcela": 1,
          "valor": 200.00
        }
      ]
    }
  ]
}

```

**Campos obrigatórios**:

`cnpj`, `tipoTitulo`, `numeroTitulo`, `clienteFornecedor`, `emissao`, `valor`, `tipoDocumento`, `contaBancaria`, `meioPagamento`, `parcelas`, `rateio`

---

##### **5. Boas Práticas**

- **Evite duplicidade**: envie cupons e títulos apenas uma vez por número/identificador.
- **Valide o JSON** antes do envio.
- **Use os endpoints públicos da API** F360 para validar centros de custo e planos de contas.
- **Monitore o rastreioId** retornado em caso de sucesso para acompanhar o status da requisição

---

##### **6. Respostas da API**

<div class="_tableContainer_16hzy_1" id="bkmrk-tipo-de-retorno-c%C3%B3di"><div class="_tableWrapper_16hzy_14 group flex w-fit flex-col-reverse" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="4423" data-start="4197"><thead data-end="4239" data-start="4197"><tr data-end="4239" data-start="4197"><th data-col-size="sm" data-end="4215" data-start="4197">Tipo de Retorno</th><th data-col-size="sm" data-end="4224" data-start="4215">Código</th><th data-col-size="md" data-end="4239" data-start="4224">Significado</th></tr></thead><tbody data-end="4423" data-start="4283"><tr data-end="4341" data-start="4283"><td data-col-size="sm" data-end="4301" data-start="4283">Sucesso</td><td data-col-size="sm" data-end="4310" data-start="4301">200</td><td data-col-size="md" data-end="4341" data-start="4310">Dados recebidos com sucesso</td></tr><tr data-end="4423" data-start="4342"><td data-col-size="sm" data-end="4360" data-start="4342">Erro</td><td data-col-size="sm" data-end="4369" data-start="4360">500</td><td data-col-size="md" data-end="4423" data-start="4369">Erro no processamento. Verifique os dados enviados</td></tr></tbody></table>

</div></div>Exemplo de resposta com sucesso:

```
{
  "rastreioId": "5737a24e-8eef-4090-9c8d-6c168af2c8a4"
}
```

---

##### **7. Benefícios da Integração**

- **Centralização** das operações financeiras (unificação)
- **Agilidade** no envio de dados
- **Redução de erros** manuais (retrabalho)
- **Visibilidade** e rastreabilidade dos dados enviados
- **Confiabilidade** na conciliação de vendas e pagamentos