Historial de cambios
Cambios importantes del API de TEALCA.
[Sin publicar]
[1.2.0] - 2026-09-03
Cambiado
GET /tracking/shipment/{shipment_identifier_list}: cada guía en la respuesta incluye los campospreshipment_numberyshipment_partner_id, vacíos cuando la guía no los tiene.POST /shipment,POST /preshipmentyPOST /warehouse/delivery-order: los camposshipment_list,preshipment_listydelivery_order_listaceptan un máximo de 20 elementos por solicitud.
Corregido
POST /shipment: los camposshipper.nameyconsignee.nameaceptan los caracteresñyÑ.
[1.1.0] - 2026-08-27
Agregado
- Todos los endpoints están disponibles también bajo el prefijo
/api/v1/. - Nuevo endpoint
GET /customer/{customer_identification}/shipments: lista las guías donde el cliente es el remitente o el destinatario, con paginación por cursor.
Cambiado
- Registrar un POD (prueba de entrega) mediante
POST /podtambién actualiza el estatus y la información de tracking de la guía. POST /pod: el campoaccount_idacepta un UUID en cualquier formato estándar. Los valores mal formados se rechazan durante la validación de la solicitud en lugar de causar un error del servidor.POST /shipment: la creación de guías corporativas se rechaza cuando la tienda destino (destination.store) no está disponible, o está bloqueada, para el contrato de la línea de facturación. El mensaje de error identifica la guía, la tienda y el motivo.
Obsoleto
- Las rutas sin el prefijo
/api/v1/se eliminarán próximamente. Se recomienda migrar a las rutas versionadas.
Corregido
PUT /shipment/{shipment_header_id}/shipment-parcel: el parámetro de la ruta acepta el ID de la guía o el número de guía.POST /shipment: los valores deshipment_header_referenceusados por guías anuladas o sustituidas pueden reutilizarse en nuevas guías.
[1.0.0] - 2026-08-20
Agregado
- Nuevo endpoint
GET /preshipment: devuelve las preguías creadas entredate_fromydate_to, cada una con su remitente, destinatario, estado actual, la fecha en que alcanzó cada etapa y los pesos declarado, validado y facturado. Los resultados se paginan concursorypage_size. El rango máximo por consulta es de 31 días. - Nuevos endpoints
/shipment-bulkpara el nuevo proceso de carga masiva de guías en MiTealca:POST /shipment-bulk,GET /shipment-bulk/list,GET /shipment-bulk/{header_id},GET /shipment-bulk/{header_id}/progressyGET /shipment-bulk/{header_id}/file.
Cambiado
GET /tracking/shipment/{shipment_identifier_list}: cada registro de tracking incluye el campoevent_id, junto coneventyevent_category, para que los sistemas que lo consumen puedan reaccionar sin depender del texto.
Corregido
- Correcciones de errores en cotización (
POST /shipment/price-calculationyGET /shipment/{shipment_identification}/price-calculation), creación de guías (POST /shipment) y la documentación pública en/api/docs.