V2 de la API de Checkout y Fulfillment ya está en beta (migración será finalizada el 23 de mayo)

Daniel Aleixo

Daniel Aleixo

Última actualización
El plazo anterior se modifica de 21/05 a 23/05 (2 días) debido a la necesidad de pruebas adicionales.

Ya está en beta la versión 2 de la API de Checkout y Fulfillment. Y, a partir de 23 de mayo, se aplicará a todas las tiendas. La V2 trae una serie de mejoras con respecto a la versión anterior y quita algunos campos y rutas que ya estaban obsoletas.

Atención
Recomendamos que usted haga todas las pruebas para evaluar los impactos y adaptar sus integraciones y personalizaciones antes del plazo final. Así, cuando realizamos la migración a la nueva versión de la API, su tienda tendrá una transición tranquila.

Compruebe abajo todo lo que cambia con la nueva versión de la API de Checkout y Fulfillment (y lo que está en beta o en stable):

  • Eliminación de los campos defaultPicker, handlerSequence y handling del objeto items, tanto en la respuesta de las rutas del carrito como en la de los pedidos (BETA). Estos campos se han creado para una funcionalidad que ya no se utiliza y nunca se llenan hoy en día.
  • Cambio del campo checkToSavePersonDataByDefault a saveUserData, en el objeto storePreferencesData de las respuestas del carrito y del pedido (BETA). ATENCIÓN: durante el período de migración, se recomienda que se mantenga la lectura de los dos campos por cuestiones de compatibilidad, pero siempre dando preferencia al nuevo.
  • Eliminación de los objetos attachmentId (o id, dependiendo de la ruta) de los grupos de attachment (shippingData, clientProfileData, giftRegistryData etc.), tanto en la respuesta de las rutas del carrito como en la de los pedidos. Este cambio resuelve problemas de redundancia (BETA).
  • Eliminación del campo templateOptions en el objeto storePreferencesData de las respuestas del carrito y del pedido (BETA). La funcionalidad que fue pensada inicialmente con ese campo no fue completamente desarrollada y hoy retorna siempre el mismo valor.
  • Eliminación del campo itemAttachment (ya obsoleto) en el objeto items, tanto en la creación de los carritos y pedidos como en la obtención de pedidos (BETA). Este campo se está eliminando por redundancia con el attachments (que ya está en STABLE) y se ha mantenido hasta hoy por compatibilidad, ya que su primera versión no era una lista.
  • El campo shippingEstimate de los SLAs, tanto de la respuesta del carrito como en la del pedido, ahora soporta valores en horas (h) y minutos (m) (BETA).
  • La ruta de callback (permiso de finalización del pedido) {host}/gatewayCallback/{gatewayReferenceId}/{transactionId}/{messageCode} (GET) se quita y se reemplaza por la ruta {host}/gatewayCallback/{orderGroup}/{messageCode} (GET). Este cambio está en BETA, pero la ruta correcta ya está en STABLE.
  • Eliminación de los campos merchantName, transactionId y payments del objeto paymentData en la respuesta de las rutas {host}/api/checkout/pub/orders/order-group/{order-group}, {host}/api/checkout/pub/orders (GET) y {host}/api/checkout/pub/orders/{orderId}. Este cambio está en BETA y quita campos obsoletos y redundantes en relación a los que ya existen en el campo transactions (que ya está en STABLE con toda la información anterior).
  • Eliminación de la ruta {host}/api/checkout/pvt/orders/order-import de importación de pedido (BETA).
  • Eliminación del campo products de las respuestas y de las requisiciones de las rutas del soporte. Esta funcionalidad nunca se ha implementado completamente y se está descontinuando (BETA).
  • Eliminación del soporte de la queryString product en la ruta {host}/checkout/cart/add. Esta funcionalidad nunca se ha implementado completamente y se está descontinuando (BETA).
  • Eliminación del objeto expectedOrderFormSections en el request de las rutas del carrito. Ahora todos los campos serán devueltos (BETA).
  • Eliminación del campo stockBalance del objeto logisticsInfo en la respuesta de la ruta {host}/api/checkout/pub/orderForms/simulation. Importante: ese campo todavía estará disponible en la ruta privada {host} / api / checkout / pvt / orderForms / simulation (BETA).
  • Eliminación de la ruta {host}/api/checkout/pvt/orders/{orderId}/updateShippingEstimateDate (BETA).
  • Corrección de los casos de error que deberían devolver código 500, pero estaban presentando el 400 (BETA).