Inicio

1. Autenticación y permisos

URL base oficial: https://connect.eod360.net/api/v1/external. Todas las rutas son de sólo lectura y la llave determina la empresa autorizada.

curl -H "X-API-Key: eod360_pro_tu_llave" \
  "https://connect.eod360.net/api/v1/external/customers?limit=100&offset=0"

2. n8n · consulta de información

1. Agrega el nodo HTTP Request.
2. Selecciona método GET.
3. Pega la URL del recurso y agrega el encabezado.

Method: GET
URL: https://connect.eod360.net/api/v1/external/customers?limit=100
Header name: X-API-Key
Header value: {{ $env.EOD360_API_KEY }}

3. Power BI · ventas detalladas

Crea el parámetro pEod360ApiKey y usa /sales/documents. La consulta obtiene páginas de 500 documentos hasta llegar a total.

let
  GetPage=(Offset as number)=>Json.Document(Web.Contents("https://connect.eod360.net",[RelativePath="api/v1/external/sales/documents",Query=[limit="500",offset=Text.From(Offset)],Headers=[#"X-API-Key"=pEod360ApiKey]])),
  First=GetPage(0),
  Pages=List.Generate(()=>First,each [offset]<[total],each GetPage([offset]+[count]),each [data]),
  Data=Table.FromRecords(List.Combine(Pages))
in Data

4. Power BI · clientes, productos, inventario y CxC

Usa la misma consulta paginada. Sólo cambia Resource y asigna el permiso de la llave correspondiente.

let
  Resource="customers",
  GetPage=(Offset as number)=>Json.Document(Web.Contents("https://connect.eod360.net",[RelativePath="api/v1/external/" & Resource,Query=[limit="500",offset=Text.From(Offset)],Headers=[#"X-API-Key"=pEod360ApiKey]])),
  First=GetPage(0), Pages=List.Generate(()=>First,each [offset]<[total],each GetPage([offset]+[count]),each [data]),
  Data=Table.FromRecords(List.Combine(Pages))
in Data

5. BI Comercial · resumen

Crea una consulta para los indicadores globales: total de ventas, documentos, clientes activos y ticket promedio.

let
  Source=Json.Document(Web.Contents("https://connect.eod360.net/api/v1/external/bi/commercial",[Headers=[#"X-API-Key"=pEod360ApiKey]])),
  Summary=Record.RemoveFields(Source,{"monthly_sales","top_customers","inactive_customers"}),
  Data=Table.FromRecords({Summary})
in Data

6. BI Comercial · ventas mensuales

Crea una segunda consulta para alimentar gráficas de tendencia mensual.

let
  Source=Json.Document(Web.Contents("https://connect.eod360.net/api/v1/external/bi/commercial",[Headers=[#"X-API-Key"=pEod360ApiKey]])),
  Data=Table.FromRecords(Source[monthly_sales])
in Data

7. BI Comercial · clientes con mayor venta

Crea una tercera consulta para ranking, última compra y acciones de reactivación.

let
  Source=Json.Document(Web.Contents("https://connect.eod360.net/api/v1/external/bi/commercial?customer_limit=100",[Headers=[#"X-API-Key"=pEod360ApiKey]])),
  Data=Table.FromRecords(Source[top_customers])
in Data

8. Validar firma de Webhook

El receptor debe responder HTTP 2xx. Verifica el cuerpo original sin volver a serializarlo con el secreto configurado en Connect.

raw_body = request.get_data()
received = request.headers.get("X-EOD360-Signature", "")
expected = "sha256=" + hmac.new(WEBHOOK_SECRET.encode(), raw_body, hashlib.sha256).hexdigest()
if not hmac.compare_digest(received, expected): abort(401)