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 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

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