Solicitudes por lotes

custombatch es un método común que te permite agrupar varias llamadas a la API, conocidas como "entradas", en una sola solicitud HTTP. Cada entrada solo hace referencia a una única llamada de método.

Los lotes personalizados son una buena opción en las siguientes situaciones:

  • Acabas de comenzar a usar la API y tienes muchos datos de productos para subir.
  • Debes sincronizar los datos locales con el servidor mediante el envío de muchas actualizaciones y eliminaciones.

Realiza solicitudes por lotes

Enviar solicitudes por lotes es similar a enviar llamadas a la API en paralelo. Ten en cuenta que no hay garantía de que el orden de las entradas definido en la solicitud esté en el mismo orden en que se ejecutan. Te recomendamos que no uses llamadas interdependientes en una solicitud por lotes única (como crear y actualizar el mismo envío).

De manera similar, las respuestas recibidas para las solicitudes por lotes pueden mostrarse en un orden diferente al de las entradas de la solicitud. Se puede usar BatchId para correlacionar solicitudes y respuestas, ya que las respuestas se pueden mostrar de forma desordenada.

Puedes agrupar las solicitudes en la API si llamas al método custombatch correspondiente:

Recursos y sus métodos por lotes personalizados correspondientes
Accounts accounts.custombatch
Accountstatuses accountstatuses.custombatch
Accounttax accounttax.custombatch
Datafeeds datafeeds.custombatch
Datafeedstatuses datafeedstatuses.custombatch
Localinventory localinventory.custombatch
Liasettings liasettings.custombatch
Pos pos.custombatch
Products products.custombatch
Productstatuses productstatuses.custombatch
Shippingsettings shippingsettings.custombatch

Límites

Para evitar errores cuando se suben lotes grandes, recomendamos limitar el tamaño de las solicitudes custombatch a un máximo de 1,000 entradas. Se aplican los siguientes valores máximos a las solicitudes custombatch:

  • 50,000 entradas por cada solicitud de custombatch
  • Tamaño de transferencia de 32 MB

Las llamadas que excedan los máximos generarán los siguientes errores request_too_large:

  • "Too many requests in a batch."
  • "Request payload size exceeds the limit: %d bytes."