Sistema de Shipping - Three-Trackr

Documentación completa del sistema de shipping y logística integrado en ThreeTrackr.

Guías Disponibles

Módulo Overview

Documentación técnica completa del módulo de shipping:

Arquitectura del sistema
Funcionalidades implementadas
Integración con Coordinadora
TODOs y mejoras futuras
Estado del desarrollo

Guía de Pruebas con Postman

Tutorial paso a paso para probar el sistema:

Configuración inicial
Flujo completo de pruebas
Ejemplos de GraphQL queries/mutations
Manejo de errores comunes
Validación de funcionalidades

Inicio Rápido

Para desarrolladores: Lee primero el Module Overview
Para testing: Sigue la Guía de Postman
Para producción: Revisa ambas guías y los TODOs pendientes

Recursos Relacionados

Código fuente: apps/api/src/modules/shipping/
Schemas de BD: packages/database/prisma/
Migraciones: packages/supabase/supabase/migrations/
GraphQL Types: apps/api/src/modules/shipping/types/

Estado Actual

Funcional: Sistema completo y listo para generar guías reales
En desarrollo: Integración automática orden→shipping
Pendiente: Más transportadoras (Servientrega, TCC, etc.)

Características Principales

Integración con Coordinadora

Sistema completo de integración con Coordinadora para envíos en Colombia:

Generación automática de guías
Cálculo de costos de envío
Seguimiento de paquetes
Manejo de estados de envío

API GraphQL

API completa para gestión de envíos:

Creación de órdenes de envío
Consulta de estados
Generación de etiquetas
Historial de envíos

Integración con Órdenes

Integración automática con el sistema de órdenes:

Creación automática de envíos
Sincronización de estados
Actualización de inventario

Soporte

Para problemas o preguntas sobre el sistema de shipping, consulta:

Esta documentación
Los comentarios en el código fuente
Los TODOs en el Module Overview

Nota: El sistema de shipping está en desarrollo activo. Consulta la documentación específica para las últimas actualizaciones.