Información importante para actualizar desde 3.1 a 4.0 de la API.
Por favor asegúrate de haber migrado primero a 3.1 antes de migrar a 4.0 3.1 Guía de migración
Cambios Incompatibles
POST
{base_url}/api/v4/
Actualizar solicitudes a .../api/v4/... En lugar de .../api/v3.1/... .
Valores monetarios
El dinero ahora se envía y se devuelve como un número entero de centavos. En 3.1 los mismos campos tomaban dólares decimales, por lo que 45.99 en 3.1 se convierte en 4599 en 4.0.
Esto se aplica a los campos de dinero en general, incluidos los totales de órdenes de compra, los impuestos, los descuentos, los precios unitarios y totales de las líneas, los montos de pago, las asignaciones, los precios unitarios de ítems y cualquier otro monto que envíes o recibas, no solo a un único campo.
Este es un cambio silencioso: el mismo payload es aceptado en ambas versiones sin error, y significa una cantidad cien veces diferente. Es fácil equivocarse en ambas direcciones.
Enviar valores de 3.1 sin cambios a 4.0 cobra cien veces de menos: un 45.99 que significaba $45.99 se lee como centavos y solo cobra alrededor de $0.46.
Leer una respuesta de 4.0 como dólares cobra cien veces de más: un 4599 devuelto son $45.99 en centavos, pero leído como dólares se convierte en $4599.00.
Una excepción: el campo amount en el punto final de reembolso ya era un número entero de centavos en 3.1 y no ha cambiado en 4.0.
Campos de contacto de nivel raíz
( first_name , last_name , email , mobile_phone )
Debe proporcionarse ahora dentro de un primaryContact objeto, o como entradas en el contacts array.
El notification_options el campo ha sido eliminado. Una escritura de cliente o suscripción que aún lo envíe se rechaza con un 400. En una escritura de orden de compra está obsoleto: aún se aplica como los destinatarios send.to de la orden de compra y la respuesta incluye una advertencia, pero se rechazará en una versión futura. Establezca doNotContact en los correos electrónicos y números de teléfono del contacto, y elija los destinatarios de una orden de compra o suscripción con send.to . En un sitio de QuickBooks que asigna métodos de pago a notificaciones, decide en su lugar la configuración de QuickBooks del comercio. Consulte Add/Update Customer para más detalles.
Los campos bill_email , bill_email_cc , bill_email_bcc ,
y billing_address han sido reemplazados por el billTo objeto.
El shipping_address Campo ha sido reemplazado por el soldTo objeto.
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 attachmentRefs Objeto, que organiza adjuntos en internal , external ,
y sourceDocument sub-campos.
Los registros ahora se identifican por _id , que es lo que devuelven las respuestas y lo que envían los ejemplos de esta documentación.
Un externalId que usted asignó sigue coincidiendo con un registro existente en una llamada de agregar/actualizar, por lo que las integraciones basadas en él siguen funcionando. Prefiera _id cuando lo tenga, y no envíe los dos apuntando a registros distintos: el _id es el que se usa para la coincidencia, y el externalId de la misma solicitud se escribe entonces en ese registro.
Los contactos son ahora registros de primera clase. Utiliza los puntos finales de Contacto para crear, recuperar y gestionar contactos de forma independiente de los clientes.