Iniciar sesiónRegistrarse

API empresarial

API REST versionada para sync ERP. Autentique con Authorization: Bearer gcn_live_… o gcn_test_…. Cree claves en el panel Business.

¿Nuevo? Empiece con la checklist de onboarding de partners.

URL base

/api/v1

OpenAPI legible por máquina: /api/v1/openapi

Colección Postman: Descargar / importar

Endpoints principales

  • GET /me — org + scopes
  • GET|POST /listings, /listings/bulk
  • GET|POST /inventory, /inventory/bulk (syncMode: upsert|replace)
  • /freight, /freight/bulk · /depots, /depots/bulk · /storage, /storage/bulk · /manufacturers, /manufacturers/bulk · /ports, /ports/bulk
  • /inquiries, /inquiries/{id}/reply
  • /organization, /webhooks, /bulk/{jobId}

Scopes

Las nuevas claves reciben todos los scopes. Restricción fina vía el modelo de datos.

  • listings:read
  • listings:write
  • inventory:read
  • inventory:write
  • freight:read
  • freight:write
  • depots:read
  • depots:write
  • storage:read
  • storage:write
  • manufacturers:read
  • manufacturers:write
  • ports:read
  • ports:write
  • inquiries:read
  • inquiries:write
  • org:read
  • org:write
  • webhooks:manage
  • bulk:write

Inicio rápido para partners

Ejemplos curl paso a paso para sync de catálogo (todos los módulos), consultas y webhooks:

docs/api-partner-guide.md

Sonda de disponibilidad: /api/v1/ready

Notas

  • Orgs no verificadas: las creaciones quedan PENDING hasta aprobación admin.
  • Orgs verificadas: creaciones/actualizaciones API se publican ACTIVE automáticamente.
  • Use externalId + Idempotency-Key para reintentos ERP seguros.
  • Bulk máx. 200 ítems/solicitud; webhooks hasta 3 reintentos con backoff.
  • Webhooks firmados HMAC (x-gcn-signature, x-gcn-timestamp).

Comprobando…