01 / Guía
Qué decisiones sí conviene convertir en reglas
Empieza por decisiones frecuentes, objetivas y respaldadas por datos que ya llegan en el pedido. Si una persona todavía necesita interpretar el caso o buscar información fuera del sistema, conserva una revisión manual.
Una buena regla puede explicarse en una oración y producir el mismo resultado aunque cambie quien prepare el paquete.
| Si revisas | Puedes decidir | Ejemplo claro |
|---|---|---|
| Peso o medidas | Etiquetar el pedido, preferir una opción o aplicar una política | Si el paquete pesa 8 kg o más, agrega la etiqueta revisión_peso. |
| País, estado o código postal | Preferir un servicio o excluir una paquetería según la ruta | Si el destino pertenece a una zona definida, aplica la preferencia de esa zona. |
| Valor o canal del pedido | Agregar seguro, solicitar firma o elegir el flujo de impresión | Si el pedido supera el umbral interno, agrega seguro y firma. |
| Formato de operación | Solicitar una guía PDF o ZPL | Si el pedido sale de una estación térmica validada, usa ZPL. |
02 / Guía
La anatomía de una regla profesional
No empieces con una lista larga de excepciones. Construye cada regla alrededor de un propósito de negocio y deja visible por qué existe. Así será más fácil revisarla cuando cambie la operación.
- 01
Condición
Define los datos que deben coincidir, por ejemplo peso y estado de destino.
- 02
Acción
Indica el único resultado que buscas: preferir, excluir, asegurar, firmar, etiquetar o elegir formato.
- 03
Prioridad
Coloca primero la política general y después las excepciones más específicas.
- 04
Vista previa
Prueba el escenario y confirma qué reglas se activan y cuál es el resultado final.
03 / Guía
Cómo resolver prioridades sin resultados inesperados
SendIt evalúa las reglas activas por prioridad. Todas las que coincidan pueden aplicar acciones; si dos reglas cambian la misma decisión, la posterior puede sustituir el resultado de la anterior. Por eso conviene ordenar primero las políticas generales y después las excepciones.
La solicitud explícita siempre tiene la última palabra. Si tu integración envía carrierCode, serviceLevel o labelFormat directamente en POST /v1/shipments, ese valor prevalece sobre una regla. Esto permite conservar reglas para el flujo normal y tomar control de un envío excepcional.
Preferir una opción no elimina las demás: si la preferencia no está disponible para esa ruta, se devuelve la lista completa de opciones.
Excluir una opción sí es un filtro estricto y puede dejar el envío sin cotizaciones. Prueba ese caso antes de activar la regla.
Una regla puede desactivarse sin borrarla mientras revisas su lógica o su prioridad.
skipShippingRules: true omite las reglas para una sola creación de envío cuando tu operación necesita resolverla manualmente.
04 / Guía
Prueba el resultado antes de crear el envío
POST /v1/shipping-rules/preview evalúa un escenario sin crear ni modificar un envío. La respuesta indica qué reglas coincidieron, cuáles acciones se aplicarían y el resultado final después de combinar prioridades.
El ejemplo prueba un paquete y un destino ilustrativos. Repite la vista previa con los casos frecuentes, los límites exactos y las excepciones de tu negocio.
POST /v1/shipping-rules/preview
X-API-Key: sk_test_...
Content-Type: application/json
{
"shipment": {
"parcel": {
"weight": 8,
"length": 40,
"width": 30,
"height": 20
},
"to": {
"country": "MX",
"state": "JAL",
"postalCode": "44100"
}
}
}05 / Guía
Una checklist antes de activar la automatización
Revisa una regla con la misma disciplina que una política operativa. El objetivo no es automatizar más decisiones, sino automatizar únicamente las que tienen datos y límites confiables.
06 / Guía
Cómo encajan las reglas en SendIt
Las reglas activas se evalúan automáticamente cuando tu sistema crea un envío con POST /v1/shipments. Puedes ordenarlas, activarlas, desactivarlas y probarlas por separado; tu ecommerce conserva la posibilidad de enviar una decisión explícita o saltar las reglas para una excepción.
SendIt está en pre-lanzamiento. Las reglas forman parte del contrato de la plataforma; las opciones que pueden preferir o excluir dependen de las integraciones y la cobertura disponibles al momento de operar.
Siguiente paso
Completa la tarea.
Preguntas frecuentes
Respuestas rápidas.
¿Cuándo conviene automatizar una decisión de envío?
Cuando ocurre con frecuencia, usa datos confiables y produce el mismo resultado sin interpretación manual. Si el criterio todavía cambia de una persona a otra, documenta primero la política.
¿Una regla puede reemplazar lo que envía mi integración?
No. Un carrierCode, serviceLevel o labelFormat explícito en la solicitud prevalece sobre las reglas aplicables.
¿Qué ocurre si la opción preferida no está disponible?
La preferencia no vacía la cotización: SendIt devuelve la lista completa de opciones disponibles para esa ruta.
¿Una exclusión puede dejar el envío sin opciones?
Sí. La exclusión es un filtro estricto, así que debes probar rutas representativas y conservar un proceso manual para ese resultado.
¿La vista previa crea o modifica un envío?
No. POST /v1/shipping-rules/preview evalúa las reglas y devuelve el resultado sin guardar cambios en un envío.
¿Qué formatos de guía puede elegir una regla?
PDF o ZPL. Usa PDF para impresión convencional y ZPL únicamente con una estación térmica compatible y validada.