Listar documentos de traslado

Herramienta MCP: transportationReceipts_listTransportationReceipts.

Lista los documentos de traslado de México ("documentos de traslado" o CFDI de traslado con el Complemento Carta Porte del SAT), con paginación y filtros.

Esta herramienta es exclusiva para México (MEX). Úsala para encontrar documentos cuando no conoces sus IDs, o para filtrar por fecha de emisión, fecha de envío, estado, cliente, factura vinculada o presencia del Complemento Carta Porte. Con complement: "yes" se listan solo las cartas porte y es la forma confiable de saber qué documentos tienen el complemento.

Devuelve hasta 30 registros por llamada, por defecto como proyección ligera (id, número, fechas, estado, cliente, numeración, factura vinculada y un resumen de los ítems trasladados). Con detail: true se devuelve el payload completo. Un registro ligero trae hasComplement: true solo cuando el payload reportó el complemento, así que la ausencia de esa marca no es prueba de que el documento no lo tenga: para responderlo, filtra con complement.

No confundas estos documentos con las facturas de venta, que viven en otra herramienta. Usa transportationReceipts_getTransportationReceipt cuando ya conoces el ID.

Esta herramienta nunca crea ni modifica nada.

Solo lectura.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
number
≥ 0

Desplazamiento desde el que empieza la lista (por ejemplo 0 para la primera página, 30 para la segunda).

number
1 to 30

Número de documentos de traslado a devolver por solicitud. Máximo 30.

string
enum

Dirección del orden. Por defecto ASC.

Allowed:
string
enum

Campo por el que se ordena ("name" es el nombre del cliente).

Allowed:
boolean

Si es true, envuelve la respuesta como { data: TransportationReceipt[], metadata: { total: number } } en lugar de devolver un arreglo plano.

string

Lista separada por comas de IDs específicos de documentos de traslado, sin espacios (por ejemplo "2,3,10"), máximo 30. ADVERTENCIA: cuando se envía este parámetro, la API ignora todos los demás filtros.

string

Filtra por fecha exacta de emisión (AAAA-MM-DD).

string

Filtra por fecha exacta de envío (AAAA-MM-DD), la fecha en que se mueve la mercancía.

string

Filtra por estado: 'open', 'closed', 'draft' o 'void'. Puede ser una lista separada por comas.

string

Filtra por el ID del cliente.

string

Filtra por número de documento, coincidencia parcial (por ejemplo "APITT" encuentra "APITT2" y "APITT3").

string

Filtra los documentos que incluyen este ID de ítem.

string

Filtra por el número de la factura de venta vinculada, coincidencia parcial.

string
enum

Filtra por el estado del timbrado del CFDI ante el SAT.

Allowed:
string
enum

Filtra por la presencia del Complemento Carta Porte del SAT: "yes" solo los documentos que lo tienen, "no" solo los que no lo tienen.

Allowed:
boolean
Defaults to false

Cuando es false (por defecto) devuelve una proyección ligera de cada documento (id, número, fecha, fecha de envío, estado, cliente, numeración, factura vinculada y resumen de ítems). Con true devuelve el payload completo de la API (dirección completa del cliente, configuración de numeración, regímenes fiscales, montos por ítem y datos del complemento). Úsalo solo cuando el usuario pida explícitamente ese nivel de detalle.

Responses

401

No autorizado

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json