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.

{
  "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.

{
  "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.