# Jadlog MCP

Servidor MCP inicial para a API Jadlog Logistica, baseado na documentacao `API-JADLOG_v2.3-1-5.pdf`.

## Configuracao

Crie um `.env` baseado em `.env.example` e informe `JADLOG_TOKEN`.

```json
{
  "mcpServers": {
    "jadlog": {
      "command": "python",
      "args": ["C:\\caminho\\para\\jadlog-mcp\\server.py"],
      "env": {
        "JADLOG_ENV_FILE": "C:\\caminho\\para\\jadlog-mcp\\.env"
      }
    }
  }
}
```

## Tools

- `jadlog_config_status`
- `jadlog_incluir_pedido`
- `jadlog_montar_payload_incluir_pedido`
- `jadlog_incluir_pedido_estruturado`
- `jadlog_montar_payload_por_pedido_totvs`
- `jadlog_incluir_pedido_por_pedido_totvs`
- `jadlog_cancelar_pedido`
- `jadlog_consultar_tracking_por_shipment_ids`
- `jadlog_consultar_tracking_por_danfes`
- `jadlog_consultar_tracking`
- `jadlog_simular_frete`
- `jadlog_consultar_cte_xml`
- `jadlog_consultar_pudos`
- `jadlog_consultar_qrcode`
- `jadlog_incluir_tratativa`

## Endpoints cobertos

- `POST /embarcador/api/pedido/incluir`
- `POST /embarcador/api/pedido/cancelar`
- `POST /embarcador/api/tracking/consultar`
- `POST /embarcador/api/frete/valor`
- `POST /embarcador/api/cte/xml`
- `GET /pickup/address/pudos`
- `GET /pickup/address/pudos/location`
- `GET /qrcodeservice/api/{shipmentId}`
- `POST /embarcador/api/tracking/incluir_tratativa`

## Exemplo de payload estruturado

Use `jadlog_montar_payload_incluir_pedido` para conferir o JSON antes de enviar, ou
`jadlog_incluir_pedido_estruturado` para montar e enviar.

```json
{
  "pedido": "123456",
  "destinatario": {
    "nome": "CLIENTE TESTE",
    "cnpjCpf": "00000000000",
    "endereco": "RUA TESTE",
    "numero": "100",
    "bairro": "CENTRO",
    "cidade": "SAO PAULO",
    "uf": "SP",
    "cep": "01001000",
    "fone": "11999999999",
    "email": "cliente@example.com"
  },
  "dfe": {
    "cfop": "6107",
    "danfeCte": "00000000000000000000000000000000000000000000",
    "nrDoc": "123",
    "serie": "1",
    "tpDocumento": 1,
    "valor": 99.9
  },
  "volumes": [
    {
      "peso": 0.3,
      "altura": 1,
      "largura": 1,
      "comprimento": 1,
      "identificador": "123456"
    }
  ]
}
```

## TOTVS Moda para Jadlog

As tools `jadlog_montar_payload_por_pedido_totvs` e
`jadlog_incluir_pedido_por_pedido_totvs` usam as variaveis `TOTVS_*` do `.env`
para buscar pedido, cliente, endereco e nota fiscal valida no TOTVS Moda.

Fluxo recomendado:

1. Chame `jadlog_montar_payload_por_pedido_totvs` para revisar o payload.
2. Se estiver correto, chame `jadlog_incluir_pedido_por_pedido_totvs`.

## Licenca

Distribuido sob a licenca MIT. Veja [LICENSE](LICENSE).