Documentación de la API 3.1Documentación de la API 4.0 SimpleDocumentación de la API 4.0

Migrando de 3.1 a 4.0 Simple

Información importante para actualizar desde 3.1 a 4.0s de la API.

Por favor asegúrate de haber migrado primero a 3.1 antes de migrar a 4.0s 3.1 Guía de migración

4.0 Simple (4.0s) es una variante simplificada de 4.0 diseñada para integraciones que prefieren una interfaz minimalista. Se mantiene external_id Identificación de registros basada y una estructura de cliente plana, por lo que la migración desde 3.1 es de menor alcance que la completa 4.0.

Cambios Incompatibles

POST
{base_url}/api/v4/
  • Actualizar solicitudes a .../api/v4/... En lugar de .../api/v3.1/... .
POST
{base_url}/api/v4/site/{site_id}/customer/addUpdate
  • El notification_options Campo ha sido eliminado del Cliente.
Productos → Artículos
  • El punto final de Productos ha sido renombrado a Artículos. Actualiza las solicitudes a site/{site_id}/item/addUpdate En lugar de site/{site_id}/product/addUpdate .
    • Afectando
    • POST
      {base_url}/api/v4/site/{site_id}/item/addUpdate
Archivos Adjuntos
  • El attachments El campo (una lista simple de URL) ha sido reemplazado por el attachment_refs Objeto, que organiza adjuntos en internal , external , y source_pdf sub-campos.
    • Afectando
    • POST
      {base_url}/api/v4/site/{site_id}/invoice/addUpdate
    • POST
      {base_url}/api/v4/site/{site_id}/customer/addUpdate
    • POST
      {base_url}/api/v4/site/{site_id}/subscription/addUpdate