Tema: En este artículo respondemos a las preguntas más frecuentes relacionadas con integraciones personalizadas de tiendas que utilizan las API de Sendcloud.
¿Cuáles son los límites de velocidad?
Límites de velocidad
Nuestra API tiene límites de velocidad que restringen el número de solicitudes que se pueden realizar por minuto. Ten en cuenta que existen diferentes límites para los endpoints relacionados con envíos.
- Solicitudes seguras (GET): 1000 solicitudes por minuto
- Solicitudes no seguras (POST/PATCH/PUT/DELETE): 100 solicitudes por minuto.
Ráfaga máxima
Los endpoints considerados no seguros tienen un límite de ráfaga definido, que es el número máximo de solicitudes simultáneas que la API puede gestionar. Esto permite un aumento temporal en la tasa de solicitudes para adaptarse a períodos cortos de alto tráfico sin superar los límites generales.
- Solicitudes no seguras (POST/PATCH/PUT/DELETE): 15 solicitudes por segundo.
HTTP 429 (Too Many Requests).Consulta más información sobre los límites de velocidad en nuestra documentación para desarrolladores.
Esto puede modificarse a discreción de Sendcloud.
Quiero crear etiquetas inmediatamente al crear un envío a través de la API. ¿Cómo puedo hacerlo?
Para crear envíos y etiquetas de envío en una sola llamada a la API, utiliza el endpoint síncrono de la API de Envíos o la API Ship an Order. La etiqueta se devolverá automáticamente en la respuesta en el campo data.parcels.label_file. Esto solo está disponible para envíos de un solo bulto (Single Collo).
¿Cómo puedo mantener la idempotencia para pedidos/envíos que importo o creo en Sendcloud?
En el contexto de las API, la idempotencia significa que realizar múltiples solicitudes produce el mismo efecto que realizar una sola. Esto evita errores del usuario y, en el caso de las API de Sendcloud, la duplicación de pedidos en nuestro sistema. Hay cuatro endpoints que intentan ser idempotentes:
Todos los endpoints POST de envíos
Utiliza el campoexternal_reference_idpara mantener la idempotencia.
¿Puedo utilizar reglas de envío al crear envíos a través de la API?
Las reglas de envío se aplicarán a los envíos que crees a través de la API, siempre que utilices los endpoints Crear un envío con reglas y/o valores predeterminados de forma síncrona o de forma asíncrona. Recomendamos utilizar la opción de envío “Carta sin franqueo” ("shipping_option_code": "sendcloud:letter") para crear tus envíos si quieres que las reglas se apliquen correctamente. Esto te permitirá omitir el objeto obligatorio ship_with, y cualquier regla configurada que afecte a la selección de la opción de envío se aplicará correctamente a tu paquete.
¿Puedo probar la API sin que se me cobren las etiquetas que cree?
Puedes utilizar la opción de envío de Sendcloud “Carta sin franqueo” ("shipping_option_code": "sendcloud:letter") para crear tus envíos. Esto te permite probar la API sin el riesgo de que se te cobren las etiquetas creadas.
Ten en cuenta que no es posible utilizar esta opción de envío para probar la creación de etiquetas de devolución. Para probar etiquetas de devolución, utiliza una opción de envío que permita solicitudes de cancelación desde Sendcloud y cancela la etiqueta antes de las 23:59 del día de su creación. Consulta nuestra documentación sobre etiquetas de prueba para más información.
Estoy recibiendo el mensaje de error “User is not allowed to announce”. ¿Qué está ocurriendo?
Asegúrate de haber seguido todos los pasos de la configuración básica de la cuenta y de haber activado un método de pago por domiciliación bancaria. Consulta: Primeros pasos con Sendcloud.
¿Puedo ver todas mis opciones de envío a través de la API cuando conecto un contrato directo con un transportista?
Sí. Si has conectado tu propio contrato con un transportista, podrás recuperar tus propias opciones de envío junto con las opciones de envío de Sendcloud realizando una solicitud al endpoint de la API de Opciones de envío. Ten en cuenta que los precios de tu contrato no se recuperarán a menos que hayas subido tus propias tarifas del transportista.
¿Puedo ver mis propios precios de mis contratos directos con transportistas cuando utilizo la API para comprobar tarifas y comparar métodos?
Sí, si has subido tus propias tarifas a tu cuenta de Sendcloud siguiendo los pasos de este artículo.
Recibo el mensaje de error “No shipping option could be found for[…]” cuando intento crear un envío a través de la API. ¿Qué está ocurriendo?
Es probable que el shipping_option_code que estás utilizando haga referencia a una opción de envío que no admite el envío hacia o desde la dirección indicada, por ejemplo, si estás utilizando un método nacional para un envío internacional. También puede ocurrir que estés intentando usar una opción de envío de devolución para un envío saliente, o viceversa. Puedes utilizar el endpoint de Opciones de envío para encontrar una opción adecuada según los parámetros definidos en la solicitud.
¿La API admite la importación de campos de notas u observaciones en los pedidos?
Sí. Por ejemplo, puedes añadir notas a los pedidos como “Por favor, envuelve este artículo para regalo antes del envío”. Estas notas también aparecerán en los albaranes o listas de picking si utilizas Pack & Go.
He creado un informe desde la API, pero mi archivo CSV está en blanco. ¿Qué está ocurriendo?
Ten en cuenta el filtro direction cuando crees la solicitud al endpoint de informes. Si especificas direction como incoming, solo verás paquetes de devolución. Si no tienes devoluciones entrantes, el informe estará vacío.
Además, debes especificar el ID de la integración en tu solicitud. No es posible crear un informe para todas tus integraciones, así que asegúrate de indicar el ID correcto para ver tus paquetes salientes o entrantes por integración.
¿Cómo puedo encontrar mi integration_id?
Puedes encontrar tu integration_id en el endpoint Retrieve a list of integrations, o desde tu panel de Sendcloud (Configuración > Integraciones > busca tu integración en la lista > Editar). El ID de la integración aparecerá al final de la URL, por ejemplo: 'https://app.sendcloud.com/v2/settings/integrations/api/95977'
¿Cómo puedo encontrar mi sender_address_id?
A través del endpoint Retrieve a list of sender addresses, o desde tu panel de Sendcloud (Configuración > Direcciones > Editar una dirección). El ID aparecerá al final de la URL, por ejemplo: 'https://app.sendcloud.com/v2/settings/addresses/sender/132258'
¿Cómo puedo encontrar mi brand_id?
A través del endpoint Retrieve configured brands, o en tu panel de Sendcloud (Configuración > Marcas > Editar una marca). El ID aparecerá al final de la URL, por ejemplo: 'https://app.sendcloud.com/v2/settings/brands/86054'
Recibo el mensaje de error “Service point delivery is not enabled for this integration.” ¿Qué está ocurriendo?
Debes habilitar la entrega en punto de servicio en el panel de Sendcloud, accediendo a Configuración > Integraciones > API > Editar > Marca la casilla para activar la entrega en punto de servicio. Esto se describe con más detalle aquí.
Los números de casa aparecen duplicados en mis etiquetas de envío cuando creo paquetes a través de la API. ¿Qué está ocurriendo?
El formato de dirección más utilizado es el siguiente:
address : Stadhuispleinhouse_number: 10
Otro método común es:
address: Stadhuisplein 10
¿Puedo crear envíos multipieza (multicollo) a través de la API?
Sí, puedes hacerlo. Esto se describe con más detalle en nuestra documentación.
¿Puedo asignar la misma marca a varias direcciones de remitente?
Sí, puedes asignar la misma marca a algunas o a todas tus direcciones de remitente.
¿Puedo asignar varias marcas a la misma dirección de remitente?
Solo se puede asignar una marca por dirección de remitente. Como alternativa, puedes crear una dirección de remitente duplicada y asignar una marca diferente a cada una. Solo una puede establecerse como dirección predeterminada, por lo que recomendamos dar a la dirección duplicada un nombre fácil de recordar para identificarla fácilmente en el panel.
¿Puedo crear envíos internacionales a través de la API?
Sí, por supuesto. Tus documentos aduaneros se generarán automáticamente siempre que los campos obligatorios (ver más abajo) se especifiquen correctamente para cada producto incluido en el envío. Esto se explica con más detalle en nuestra documentación: Envíos internacionales
¿Qué campos son obligatorios para envíos internacionales?
customs_invoice_numbercustoms_shipment_type-
country_state(Obligatorio solo para Australia, Canadá, Italia y EE. UU.) -
parcel_items-
origin_country(ISO 2) hs_code
-
Artículos y recursos relacionados
→ Documentación de la API y Guía de inicio rápido
→ Referencia de la API de Sendcloud