Carta porte v3.1
INFORMACION SOBRE CARTA PORTE V3.1
La version de carta porte 3.1 se encuentra vigente desde el 17 de julio de 2024, es una iteración de carta porte 3.0 por lo que es importante tomar en cuenta los cambios presentados en esta documentación.
Introducción
Este complemento se utiliza para incorporar información adicional al Comprobante Fiscal Digital por Internet (CFDI) relacionada con los bienes y/o mercancías, las ubicaciones de origen, los puntos intermedios y los destinos, así como los detalles relativos al medio de transporte utilizado. Este proceso es aplicable a bienes y mercancías que se desplazan por vía terrestre, férrea, aérea o marítima. El objetivo es proporcionar una visión integral de la cadena logística, lo que incluye no solo la identificación de los productos transportados, sino también la trazabilidad a lo largo de su recorrido, permitiendo así un mejor control y seguimiento de las operaciones de transporte.
Nodos carta porte 3.1
En esta sección, se muestran los nodos que conforman la carta porte en su versión 3.1, acompañados de una explicación sobre cómo deben ser enviados, junto con ejemplos de código para facilitar su integración.
Tip
A continuacion se utilizara una etiqueta como esta nuevo para señalar los cambios que se integraron con la version 3.0 y la etiqueta nuevo 3.1 para poder identificar los cambios que se realizaron para la version 3.1 del complemento carta porte.
CartaPorte
Es el nodo principal que contiene toda la información relacionada a el complemento carta porte v3.1 y este debe contener la informacion que corresponde a tu caso de cualquiera de los siguientes nodos.
Importante
Es importante tener en cuenta que la Carta Porte es un complemento que se puede adjuntar al emitir un Comprobante Fiscal Digital por Internet (CFDI). En consecuencia, se integra en la estructura general del CFDI. Si requieres consultar la información necesaria para generar un CFDI al que desees agregar la Carta Porte, puedes hacerlo a través de este enlace.
Nodo: CartaPorte | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
Version nuevo 3.1 | String | Requerido | Atributo requerido con valor prefijado en el cual se indica la versión del complemento Carta Porte. Para esta version debe enviar "Version": "3.1" |
IdCCP nuevo | String | Opcional | Atributo requerido para expresar los 36 caracteres del folio del complemento Carta Porte (IdCCP) de la transacción de timbrado conforme al estándar RFC 4122, para la identificación del CFDI con complemento Carta Porte. Es importante tomar en cuenta que este dato puede ser enviado en la peticion a nuestro sistema si prefieres personalizarlo, pero en el caso de que no se envie este dato nosotros proporcionaremos un IdCCP para tu carta porte. Patrón: [C]{3}[a-f0-9A-F]{5}-[a-f0-9A-F]{4}-[a-f0-9A-F]{4}-[a-f0-9A-F]{4}-[a-f0-9A-F]{12} |
TranspInternac | String | Requerido | Atributo requerido para expresar si los bienes y/o mercancías que son transportadas ingresan o salen del territorio nacional. |
RegimenesAduaneros nuevo 3.1 | Arreglo | Opcional | Nodo condicional para registrar los distintos tipos de regímenes aduaneros a los cuales se destinan los bienes y/o mercancías que se trasladan a través de los distintos medios de transporte. |
EntradaSalidaMerc | String | Opcional | Atributo condicional para precisar si los bienes y/o mercancías ingresan o salen del territorio nacional. |
PaisOrigenDestino | String | Opcional | Atributo condicional para registrar la clave del país de origen o destino de los bienes y/o mercancías que se trasladan a través de los distintos medios de transporte. |
ViaEntradaSalida | String | Opcional | Atributo condicional para registrar la vía de ingreso o salida de los bienes y/o mercancías en territorio nacional. |
TotalDistRec | Numerico | Opcional | Atributo condicional para indicar en kilómetros, la suma de las distancias recorridas, registradas en el atributo “DistanciaRecorrida”, para el traslado de los bienes y/o mercancías. |
RegistroISTMO nuevo | String | Opcional | Atributo opcional para registrar las regiones, sí el traslado de los bienes y/o mercancías se realiza al interior de los Polos de Desarrollo para el Bienestar del istmo de Tehuantepec. |
UbicacionPoloOrigen nuevo | String | Opcional | Atributo condicional para registrar la región en donde inicia el traslado de los bienes y/o mercancias al interior de los Polos de Desarrollo para el Bienestar del istmo de Tehuantepec. |
UbicacionPoloDestino nuevo | String | Opcional | Atributo condicional para registrar la región en donde termina el traslado de los bienes y/o mercancias al interior de los Polos de Desarrollo para el Bienestar del istmo de Tehuantepec. |
Ubicaciones | Arreglo | Requerido | Nodo requerido para registrar las distintas ubicaciones que sirven para indicar el domicilio del origen y/o destino que tienen los bienes y/o mercancías que se trasladan a través de los distintos medios de transporte. |
Mercancias | Arreglo | Requerido | Nodo requerido para registrar la información de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. |
FiguraTransporte | Arreglo | Opcional | Nodo condicional para indicar los datos de la(s) figura(s) del transporte que interviene(n) en el traslado de los bienes y/o mercancías realizado a través de los distintos medios de transporte dentro del territorio nacional, cuando el dueño de dicho medio sea diferente del emisor del comprobante con el complemento Carta Porte. |
RegimenesAduaneros
nuevo 3.1
Tip
Este nodo es nuevo respecto a la version 3.0 de carta porte, anteriormente el atributo RegimenAduanero nos permitia enviar una clave de regimen aduanero, en esta actualización se actualiza por este nuevo nodo que nos permite enviar multiples regimenes aduaneros, se ha añadido este nuevo nodo y los elementos que contiene.
Nodo: Ubicaciones (RegimenesAduaneros → RegimenAduaneroCCP) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
RegimenAduaneroCCP nuevo 3.1 | Arreglo | Requerido | Nodo requerido para expresar el régimen aduanero al cual se destina el bien y/o mercancía. |
RegimenAduaneroCCP
nuevo 3.1
Nodo: Ubicaciones (RegimenesAduaneros → RegimenAduaneroCCP → RegimenAduanero) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
RegimenAduanero nuevo 3.1 | String | Requerido | Atributo requerido para expresar el tipo de régimen aplicado por la aduana a los bienes y/o mercancías de procedencia extranjera. |
Ubicaciones
Nodo: Ubicaciones (CartaPorte → Ubicaciones) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
Ubicacion | Arreglo | Requerido | Nodo requerido para registrar la ubicación que sirve para indicar el domicilio del origen y/o destino parcial o final, que tienen los bienes y/o mercancías que se trasladan a través de los distintos medios de transporte. |
Ubicacion
Nodo: Ubicacion (CartaPorte → Ubicaciones → Ubicacion) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
TipoUbicacion | String | Requerido | Atributo requerido para precisar si el tipo de ubicación corresponde al origen o destino de las ubicaciones para el traslado de los bienes y/o mercancías en los distintos medios de transporte. |
IDUbicacion | String | Opcional | Atributo condicional para registrar una clave que sirva para identificar el punto de salida o entrada de los bienes y/o mercancías que se trasladan a través de los distintos medios de transporte, la cual estará integrada de la siguiente forma: para origen el acrónimo “OR” o para destino el acrónimo “DE” seguido de 6 dígitos numéricos asignados por el contribuyente que emite el comprobante para su identificación. Patrón: (OR|DE)[0-9]{6} |
RFCRemitenteDestinatario | String | Requerido | Atributo requerido para registrar el RFC del remitente o destinatario de los bienes y/o mercancías que se trasladan a través de los distintos medios de transporte. |
NombreRemitenteDestinatario | String | Opcional | Atributo opcional para registrar el nombre del remitente o destinatario de los bienes y/o mercancías que se trasladan a través de los distintos medios de transporte. |
NumRegIdTrib | String | Opcional | Atributo condicional para registrar el número de identificación o registro fiscal del país de residencia, para los efectos fiscales del remitente o destinatario de los bienes y/o mercancías que se trasladan cuando se trate de residentes en el extranjero. |
ResidenciaFiscal | String | Opcional | Atributo condicional para registrar la clave del país de residencia para efectos fiscales del remitente o destinatario de los bienes y/o mercancías, conforme el catálogo de CFDI c_Pais publicado en el portal del SAT en Internet de acuerdo a la especificación ISO 3166-1. |
NumEstacion | String | Opcional | Atributo condicional para registrar la clave de la estación de origen o destino para el traslado de los bienes y/o mercancías que se realiza a través de los distintos medios de transporte, esto de acuerdo al valor de la columna “Clave identificación” del catálogo c_Estaciones del complemento Carta Porte que permita asociarla al tipo de transporte. |
NombreEstacion | String | Opcional | Atributo condicional para registrar el nombre de la estación de origen o destino por la que se pasa para efectuar el traslado de los bienes y/o mercancías a través de los distintos medios de transporte, conforme al catálogo c_Estaciones del complemento Carta Porte. |
NavegacionTrafico | String | Opcional | Atributo condicional para registrar el tipo de puerto de origen o destino en el cual se documentan los bienes y/o mercancías que se trasladan vía marítima. |
FechaHoraSalidaLlegada | String | Requerido | Atributo requerido para registrar la fecha y hora estimada en la que salen o llegan los bienes y/o mercancías de origen o al destino, respectivamente. Se expresa en la forma |
TipoEstacion | String | Opcional | Atributo condicional para registrar el tipo de estación por el que pasan los bienes y/o mercancías durante su traslado a través de los distintos medios de transporte. |
DistanciaRecorrida | Numerico | Opcional | Atributo condicional para registrar en kilómetros la distancia recorrida entre la ubicación de origen y la de destino parcial o final, por los distintos medios de transporte que trasladan los bienes y/o mercancías. |
Domicilio | Arreglo | Opcional | Nodo condicional para registrar información del domicilio de origen y/o destino de los bienes y/o mercancías que se trasladan a través de los distintos medios de transporte. |
Domicilio
Nodo: Domicilio (CartaPorte → Ubicaciones → Ubicacion → Domicilio) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
Calle | String | Opcional | Atributo opcional para registrar la calle en la que está ubicado el domicilio de origen y/o destino de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. |
NumeroExterior | String | Opcional | Atributo opcional que sirve para registrar el número exterior del domicilio de origen y/o destino de los bienes y/o mercancías que se trasladan en los distintos medios del transporte. |
NumeroInterior | String | Opcional | Atributo opcional que sirve para registrar el número interior, en caso de existir, del domicilio de origen y/o destino de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. |
Colonia | String | Opcional | Atributo opcional que sirve para registrar la clave de la colonia o dato análogo, del domicilio de origen y/o destino de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. |
Localidad | String | Opcional | Atributo opcional que sirve para registrar la ciudad, población, o dato análogo del domicilio de origen y/o destino de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. |
Referencia | String | Opcional | Atributo opcional para registrar una referencia geográfica adicional que permita una fácil o precisa ubicación del domicilio de origen y/o destino de los bienes y/o mercancías que se trasladan en los distintos medios de transporte; por ejemplo, las coordenadas del GPS. |
Municipio | String | Opcional | Atributo opcional que sirve para registrar el municipio, delegación o alcaldía, condado o dato análogo del domicilio de origen y/o destino de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. |
Estado | String | Requerido | Atributo requerido para registrar el estado, entidad, región, comunidad, o dato análogo en donde se encuentra ubicado el domicilio del origen y/o destino de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. |
Pais | String | Requerido | Atributo requerido que sirve para registrar la clave del país en donde se encuentra ubicado el domicilio del origen y/o destino de los bienes y/o mercancías que se trasladan en los distintos medios de transporte, conforme con el catálogo de c_Pais del CFDI, publicado en el portal del SAT en Internet de acuerdo a la especificación ISO 3166-1. |
CodigoPostal | String | Requerido | Atributo requerido para registrar el código postal en donde se encuentra el domicilio del origen y/o destino de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. |
Mercancias
Nodo: Mercancias (CartaPorte → Mercancias) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
PesoBrutoTotal | Numerico | Requerido | Atributo requerido para registrar la suma del peso bruto total estimado de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. |
UnidadPeso | String | Requerido | Atributo requerido para registrar la clave de la unidad de medida estandarizada del peso de los bienes y/o mercancías que se trasladan a través de los distintos medios de transporte. |
PesoNetoTotal | Numerico | Opcional | Atributo condicional para registrar la suma de los valores indicados en el atributo “PesoNeto” del nodo “DetalleMercancia”. |
NumTotalMercancias | Numerico | Requerido | Atributo requerido para registrar el número total de los bienes y/o mercancías que se trasladan en los distintos medios de transporte, identificándose por cada nodo "Mercancia" registrado en el complemento. |
CargoPorTasacion | String | Opcional | Atributo opcional para expresar el monto del importe pagado por la tasación de los bienes y/o mercancías que se trasladan vía aérea. |
LogisticaInversaRecoleccionDevolucion nuevo | String | Opcional | Atributo condicional para expresar si se hace uso de alguno de los servicios de logística inversa, recolección o devolución para el traslado de los bienes y/o mercancías. |
Mercancia | Arreglo | Requerido | Nodo requerido para registrar detalladamente la información de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. |
Autotransporte | Arreglo | Opcional | Nodo condicional para registrar la información que permita la identificación del autotransporte de carga, por medio del cual se trasladan los bienes y/o mercancías, que transitan a través de las carreteras del territorio nacional. |
TransporteMaritimo | Arreglo | Opcional | Nodo condicional para registrar la información que permita la identificación de la embarcación a través de la cual se trasladan los bienes y/o mercancías por vía marítima. |
TransporteAereo | Arreglo | Opcional | Nodo condicional para registrar la información que permita la identificación del transporte aéreo por medio del cual se trasladan los bienes y/o mercancías. |
TransporteFerroviario | Arreglo | Opcional | Nodo condicional para registrar la información que permita la identificación del carro o contenedor en el que se trasladan los bienes y/o mercancías por vía férrea. |
Mercancia
Nodo: Mercancia (CartaPorte → Mercancias → Mercancia) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
BienesTransp | String | Requerido | Atributo requerido para registrar la clave de producto de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. |
ClaveSTCC | String | Opcional | Atributo opcional para expresar la clave de producto de la STCC (por sus siglas en inglés, Standard Transportation Commodity Code), cuando el medio de transporte utilizado para el traslado de los bienes y/o mercancías sea ferroviario. |
Descripcion | String | Requerido | Atributo requerido para detallar las características de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. |
Cantidad | Numerico | Requerido | Atributo requerido para expresar la cantidad total de los bienes y/o mercancías que se trasladan a través de los distintos medios de transporte. |
ClaveUnidad | String | Requerido | Atributo requerido para registrar la clave de la unidad de medida estandarizada aplicable para la cantidad de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. La unidad debe corresponder con la descripción de los bienes y/o mercancías registrados. |
Unidad | String | Opcional | Atributo opcional para registrar la unidad de medida propia para la cantidad de los bienes y/o mercancías que se trasladan a través de los distintos medios de transporte. La unidad debe corresponder con la descripción de los bienes y/o mercancías. |
Dimensiones | String | Opcional | Atributo opcional para expresar las medidas del empaque de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. Se debe registrar la longitud, la altura y la anchura en centímetros o en pulgadas, separados dichos valores con una diagonal, i.e. |
MaterialPeligroso | String | Opcional | Atributo condicional para precisar que los bienes y/o mercancías que se trasladan son considerados o clasificados como material peligroso. |
CveMaterialPeligroso nuevo 3.1 | String | Opcional | Atributo condicional para indicar la clave del tipo de material peligroso que se transporta de acuerdo a la NOM-002-SCTSEMAR ARTF/2023, o la que la sustituya. |
Embalaje | String | Opcional | Atributo condicional para precisar la clave del tipo de embalaje que se requiere para transportar el material o residuo peligroso. |
DescripEmbalaje | String | Opcional | Atributo opcional para expresar la descripción del embalaje de los bienes y/o mercancías que se trasladan y que se consideran material o residuo peligroso. |
SectorCOFEPRIS nuevo | String | Opcional | Atributo opcional para expresar la clasificación del producto que se traslada a través de los distintos medios de transporte y que debe contar con autorización por la autoridad correspondiente. |
NombreIngredienteActivo nuevo | String | Opcional | Atributo condicional para expresar el nombre común del ingrediente activo de los precursores, químicos de uso dual, plaguicidas o fertilizantes que se trasladan a través de los distintos medios de transporte. |
NomQuimico nuevo | String | Opcional | Atributo condicional para expresar el nombre de la sustancia activa de los precursores, químicos de uso dual o sustancias tóxicas que se traslada a través de los distintos medios de transporte. |
DenominacionGenericaProd nuevo | String | Opcional | Atributo condicional para expresar el fármaco o la sustancia activa del medicamento, psicotrópico o estupefaciente que se traslada a través de los distintos medios de transporte. |
DenominacionDistintivaProd nuevo | String | Opcional | Atributo condicional para expresar la marca con la que se comercializa el producto o nombre que le asigna el laboratorio o fabricante a sus especialidades farmacéuticas con el fin de distinguirlas de otras similares del medicamento, psicotrópico o estupefaciente que se traslada a través de los distintos medios de transporte. |
Fabricante nuevo | String | Opcional | Atributo condicional para expresar el nombre o razón social del establecimiento que realiza la fabricación o manufactura del medicamento, precursor, químico de uso dual, psicotrópico o estupefaciente que se traslada a través de los distintos medios de transporte. |
FechaCaducidad nuevo | String | Opcional | Atributo condicional para registrar la fecha de caducidad del medicamento, psicotrópico o estupefaciente; o para expresar la fecha de reanálisis del precursor o químico de Se expresa en la forma AAAA-MM-DD. |
LoteMedicamento nuevo | String | Opcional | Atributo condicional para expresar la denominación que identifica y confiere trazabilidad del medicamento, precursor, químico de uso dual, psicotrópico o estupefaciente elaborado en un ciclo de producción, bajo condiciones equivalentes de operación y durante un periodo. |
FormaFarmaceutica nuevo | String | Opcional | Atributo condicional para expresar la forma farmacéutica o mezcla del medicamento, precursor, químico de uso dual, psicotrópico o estupefaciente que presenta ciertas características físicas para su adecuada dosificación, conservación y administración. |
CondicionesEspTransp nuevo | String | Opcional | Atributo condicional para expresar la condición en la cual es necesario mantener el medicamento, precursor, químico de uso dual, psicotrópicos o estupefacientes durante el traslado y almacenamiento. |
RegistroSanitarioFolioAutorizacion nuevo | String | Opcional | Atributo condicional para expresar el registro sanitario o folio de autorización con el que cuenta la empresa para el traslado del medicamento, psicotrópico o estupefaciente. |
PermisoImportacion nuevo | String | Opcional | Atributo condicional para registrar el folio del permiso de importación con el que cuenta el medicamento, precursor, químico de uso dual, psicotrópico o estupefaciente. |
FolioImpoVUCEM nuevo | String | Opcional | Atributo condicional para registrar el número de folio de importación VUCEM para la identificación del documento, para el traslado de medicamentos, precursores o químicos de uso dual, sustancias tóxicas, plaguicidas o fertizantes. |
NumCAS nuevo | String | Opcional | Atributo condicional para expresar el número Chemical Abstracts Service (CAS) con el que se identifica el compuesto químico de la sustancia tóxica. |
RazonSocialEmpImp nuevo | String | Opcional | Atributo condicional para expresar el nombre o razón social de la empresa importadora de las sustancias tóxicas. |
NumRegSanPlagCOFEPRIS nuevo | String | Opcional | Atributo condicional para expresar el número de registro sanitario para plaguicidas o fertilizantes cuya importación, comercialización y uso están permitidos en México, mismo que emite la Comisión Intersecretarial para el Control del Proceso y Uso de Plaguicidas, Fertilizantes y Sustancias Tóxicas (CICLOPLAFEST). |
DatosFabricante nuevo | String | Opcional | Atributo condicional para registrar el país y nombre o razón social de quien produce o fabrica el ingrediente activo del plaguicida o fertilizante. |
DatosFormulador nuevo | String | Opcional | Atributo condicional para registrar el país y nombre o razón social de quien formula el ingrediente activo del plaguicida o fertilizante. |
DatosMaquilador nuevo | String | Opcional | Atributo condicional para registrar el país y nombre o razón social de quien maquila el ingrediente activo del plaguicida o fertilizante. |
UsoAutorizado nuevo | String | Opcional | Atributo condicional para registrar el uso autorizado del plaguicida o fertilizante de acuerdo a la regulación del país. |
PesoEnKg | Numerico | Requerido | Atributo requerido para indicar en kilogramos el peso estimado de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. |
ValorMercancia | String | Opcional | Atributo condicional para expresar el monto del valor de los bienes y/o mercancías que se trasladan en los distintos medios de transporte, de acuerdo al valor mercado, al valor pactado en la contraprestación o bien al valor estimado que determine el contribuyente. |
Moneda | String | Opcional | Atributo condicional para identificar la clave de la moneda utilizada para expresar el valor de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. Cuando se usa moneda nacional se registra MXN, de acuerdo a la especificación ISO 4217. |
FraccionArancelaria nuevo 3.1 | String | Opcional | Atributo opcional que sirve para expresar la clave de la fracción arancelaria que corresponde con la descripción de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. |
UUIDComercioExt | String | Opcional | Atributo opcional que sirve para expresar la clave de la fracción arancelaria que corresponde con la descripción de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. |
TipoMateria nuevo | String | Opcional | Atributo condicional para expresar el estado de la materia o producto al realizar una operación de comercio exterior a través de los distintos medios de transporte. |
DescripcionMateria nuevo | String | Opcional | Atributo condicional para expresar la descripción del estado de la materia o producto al realizar una operación de comercio exterior a través de los distintos medios de transporte. |
DocumentacionAduanera | Arreglo | Opcional | Nodo condicional para registrar la información del(los) documento(s) aduanero(s) que se encuentra(n) asociado(s) al traslado de los bienes y/o mercancías por los distintos medios de transporte de procedencia extranjera para acreditar la legal estancia o tenencia durante su traslado en territorio nacional. |
GuiasIdentificacion | Arreglo | Opcional | Nodo condicional para registrar la información del(los) número(s) de guía(s) que se encuentre(n) asociado(s) al(los) paquete(s) que se traslada(n) dentro del territorio nacional. |
DetalleMercancia | Arreglo | Opcional | Nodo condicional para registrar especificaciones de los bienes y/o mercancías que se trasladan a través de los distintos medios de transporte. |
FIguratransporte | Arreglo | Opcional | Nodo condicional para indicar los datos de la(s) figura(s) del transporte que interviene(n) en el traslado de los bienes y/o mercancías realizado a través de los distintos medios de transporte dentro del territorio nacional, cuando el dueño de dicho medio sea diferente del emisor del comprobante con el complemento Carta Porte. |
DocumentacionAduanera
nuevo
Nodo: DocumentacionAduanera nuevo (CartaPorte → Mercancias → Mercancia → DocumentacionAduanera) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
TipoDocumento nuevo | String | Requerido | Atributo requerido para expresar el tipo de documento aduanero que se encuentra asociado al traslado de los bienes y/o mercancías de procedencia extranjera durante su traslado en territorio nacional. |
NumPedido nuevo | String | Opcional | Atributo condicional para expresar el número de pedimento de importación que se encuentra asociado con el traslado de los bienes y/o mercancías de procedencia extranjera para acreditar la legal estancia y tenencia durante su traslado en territorio nacional, el cual se expresa en el siguiente formato: últimos 2 dígitos del año de validación seguidos por dos espacios, 2 dígitos de la aduana de despacho seguidos por dos espacios, 4 dígitos del número de la patente seguidos por dos espacios, 1 dígito que corresponde al último dígito del año en curso, salvo que se trate de un pedimento consolidado iniciado en el año inmediato anterior o del pedimento original de una rectificación, seguido de 6 dígitos de la numeración progresiva por aduana. |
IdentDocAduanero nuevo | String | Opcional | Atributo condicional para expresar el identificador o folio del documento aduanero que se encuentra asociado al traslado de los bienes y/o mercancías de procedencia extranjera para acreditar la legal estancia o tenencia durante su traslado en territorio nacional. |
RFCImpo nuevo | String | Opcional | tributo condicional para expresar el RFC del importador de los bienes y/o mercancías que fue registrado en la documentación aduanera correspondiente y este se encuentre en la lista de RFC inscritos no cancelados del SAT (l_RFC). |
GuiasIdentificacion
Nodo: GuiasIdentificacion (CartaPorte → Mercancias → Mercancia → GuiasIdentificacion) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
NumeroGuiaIdentificacion | String | Requerido | Atributo requerido para expresar el número de guía de cada paquete que se encuentra asociado con el traslado de los bienes y/o mercancías en territorio nacional. |
DescripGuiaIdentificacion | String | Requerido | Atributo requerido para expresar la descripción del contenido del paquete o carga registrada en la guía, o en el número de identificación, que se encuentra asociado con el traslado de los bienes y/o mercancías dentro del territorio nacional. |
PesoGuiaIdentificacion | Numerico | Requerido | Atributo requerido para indicar en kilogramos, el peso del paquete o carga que se está trasladando en territorio nacional y que se encuentra registrado en la guía o el número de identificación correspondiente. |
CantidadTransporta
Nodo: CantidadTransporta (CartaPorte → Mercancias → Mercancia → CantidadTransporta) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
Cantidad | Numerico | Requerido | Nodo opcional para registrar la cantidad de los bienes y/o mercancías que se trasladan a través de los distintos medios de transporte, que será captada o distribuida en distintos puntos, a fin de identificar el punto de origen y destino correspondiente. |
IDOrigen | String | Requerido | Atributo requerido para expresar la clave del identificador del origen de los bienes y/o mercancías que se trasladan por los distintos medios de transporte, de acuerdo al valor registrado en el atributo “IDUbicacion”, del nodo “Ubicacion”. Patrón: OR[0-9]{6} |
IDDestino | String | Requerido | Atributo requerido para registrar la clave del identificador del destino de los bienes y/o mercancías que se trasladan a través de los distintos medios de transporte, de acuerdo al valor registrado en el atributo “IDUbicacion”, del nodo “Ubicacion”. Patrón: DE[0-9]{6} |
CvesTransporte | String | Opcional | Atributo condicional para indicar la clave a través de la cual se identifica el medio por el que se transportan los bienes y/o mercancías. |
DetalleMercancia
Nodo: DetalleMercancia (CartaPorte → Mercancias → Mercancia → DetalleMercancia) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
UnidadPesoMerc nuevo | String | Requerido | Atributo requerido para registrar la clave de la unidad de medida estandarizada del peso de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. |
PesoBruto | Numerico | Requerido | Atributo requerido para registrar el peso bruto total de los bienes y/o mercancías que se trasladan a través de los diferentes medios de transporte. |
PesoNeto | Numerico | Requerido | Atributo requerido para registrar el peso neto total de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. |
PesoTara | Numerico | Requerido | Atributo requerido para registrar el peso bruto, menos el peso neto de los bienes y/o mercancías que se trasladan a través de los distintos medios de transporte. |
NumPiezas | Numerico | Opcional | Atributo opcional para registrar el número de piezas de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. |
Autotransporte
Nodo: Autotransporte (CartaPorte → Mercancias → Autotransporte) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
PermSCT | String | Requerido | Atributo requerido para registrar la clave del tipo de permiso proporcionado por la Secretaría de Infraestructura, Comunicaciones y Transportes (SICT) o la autoridad análoga, el cual debe corresponder con el tipo de autotransporte utilizado para el traslado de los bienes y/o mercancías de acuerdo al catálogo correspondiente. |
NumPermisoSCT | String | Requerido | Atributo requerido para registrar el número del permiso otorgado por la Secretaría de Infraestructura, Comunicaciones y Transportes (SICT) o la autoridad correspondiente, al autotransporte utilizado para el traslado de los bienes y/o mercancías. |
IdentificacionVehicular | Arreglo | Requerido | Nodo requerido para registrar los datos de identificación del autotransporte en el que se trasladan los bienes y/o mercancías. |
Seguros | Arreglo | Requerido | Nodo requerido para registrar los datos de las pólizas de seguro que cubren los riesgos en el traslado de los bienes y/o mercancías. |
Remolques | Arreglo | Opcional | Nodo condicional para registrar los datos del(los) remolque(s) o semirremolque(s) que se adaptan al autotransporte para realizar el traslado de los bienes y/o mercancías. |
IdentificacionVehicular
Nodo: IdentificacionVehicular (CartaPorte → Mercancias → Autotransporte → IdentificacionVehicular) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
ConfigVehicular | String | Requerido | Atributo requerido para expresar la clave de nomenclatura del autotransporte que es utilizado para transportar los bienes y/o mercancías. |
PesoBrutoVehicular nuevo | Numerico | Requerido | Atributo requerido para indicar en toneladas el peso bruto vehicular permitido del autotransporte de acuerdo a la NOM SCT-012-2017, o la que la sustituya, que es utilizado para realizar el traslado de los bienes y/o mercancías. |
PlacaVM | String | Requerido | Atributo requerido para registrar solo los caracteres alfanuméricos, sin guiones ni espacios de la placa vehicular del autotransporte que es utilizado para transportar los bienes y/o mercancías. |
AnioModeloVM | Numerico | Requerido | Atributo requerido para registrar el año del autotransporte que es utilizado para transportar los bienes y/o mercancías. |
Seguros
Nodo: Seguros (CartaPorte → Mercancias → Autotransporte → Seguros) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
AseguraRespCivil | String | Requerido | Atributo requerido para registrar el nombre de la aseguradora que cubre los riesgos por responsabilidad civil del autotransporte utilizado para el traslado de los bienes y/o mercancías. |
PolizaRespCivil | String | Requerido | Atributo requerido para registrar el número de póliza asignado por la aseguradora, que cubre los riesgos por responsabilidad civil del autotransporte utilizado para el traslado de los bienes y/o mercancías. |
AseguraMedAmbiente | String | Opcional | Atributo condicional para registrar el nombre de la aseguradora, que cubre los posibles daños al medio ambiente cuando exista al menos una mercancía tipificada como material peligroso se debe registrar la información del atributo “AseguraMedAmbiente” (aplicable para los transportistas de materiales, residuos o remanentes y desechos peligrosos. |
PolizaMedAmbiente | String | Opcional | Atributo condicional para registrar el número de pólizaasignado por la aseguradora, que cubre los posibles daños al medio ambiente cuando exista al menos una mercancía tipificada como material peligroso se debe registrar la información del atributo “AseguraMedAmbiente” (aplicable para los transportistas de materiales, residuos o remanentes y desechos peligrosos). |
AseguraCarga | String | Opcional | Atributo opcional para registrar el nombre de la aseguradora que cubre los riesgos de la carga (bienes y/o mercancías) del autotransporte utilizado para el traslado. |
PolizaCarga | String | Opcional | Atributo opcional para expresar el número de póliza asignado por la aseguradora que cubre los riesgos de la carga (bienes y/o mercancías) del autotransporte utilizado para el traslado. |
PrimaSeguro | String | Opcional | Atributo opcional para registrar el valor del importe por el cargo adicional convenido entre el transportista y el cliente, el cual será igual al valor de la prima del seguro contratado, conforme a lo establecido en la cláusula novena del Acuerdo por el que se homologa la Carta de Porte regulada por la Ley de Caminos, Puentes y Autotransporte Federal, con el complemento Carta Porte que debe acompañar al Comprobante Fiscal Digital por Internet (CFDI). |
Remolques
Nodo: Remolques (CartaPorte → Mercancias → Autotransporte → Remolques) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
Remolque | Arreglo | Requerido | Nodo requerido para expresar la información del(los) remolque(s) o semirremolque(s) que se adapta(n) al autotransporte para realizar el traslado de los bienes y/o mercancías. |
Remolque
Nodo: Remolque (CartaPorte → Mercancias → Autotransporte → Remolques → Remolque) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
SubTipoRem | String | Requerido | Nodo requerido para expresar la información del(los) remolque(s) o semirremolque(s) que se adapta(n) al autotransporte para realizar el traslado de los bienes y/o mercancías. |
Placa | String | Requerido | Atributo requerido para registrar los caracteres alfanuméricos, sin guiones ni espacios de la placa vehicular del remolque o semirremolque que es utilizado para transportar los bienes y/o mercancías. |
TransporteMaritimo
Nodo: TransporteMaritimo (CartaPorte → Mercancias → TransporteMaritimo) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
PermSCT | String | Opcional | Atributo opcional para registrar la clave del permiso proporcionado por la Secretaría de Infraestructura, Comunicaciones y Transportes (SICT), la cual debe corresponder con la embarcación que se está utilizando para el traslado de los bienes y/o mercancías, de acuerdo al catálogo correspondiente. |
NumPermisoSCT | String | Opcional | Atributo opcional para registrar el número del permiso otorgado por la Secretaría de Infraestructura, Comunicaciones y Transportes (SICT), a la embarcación utilizada para el traslado de los bienes y/o mercancías. |
NombreAseg | String | Opcional | Atributo opcional para registrar el nombre de la aseguradora que cubre la protección e indemnización por responsabilidad civil de la embarcación en el traslado de los bienes y/o mercancías. |
NumPolizaSeguro | String | Opcional | Atributo opcional para registrar el número de póliza asignada por la aseguradora que cubre la protección e indemnización por responsabilidad civil de la embarcación en el traslado de los bienes y/o mercancías. |
TipoEmbarcacion | String | Requerido | Atributo requerido para registrar la clave de identificación del tipo de embarcación que es utilizado para trasladar los bienes y/o mercancías. |
Matricula | String | Requerido | Atributo requerido para registrar el número de la matrícula o registro de la embarcación que es utilizada para transportar los bienes y/o mercancías. |
NumeroOMI | String | Requerido | Atributo requerido para registrar el número de identificación asignado por la Organización Marítima Internacional, a la embarcación encargada de transportar los bienes y/o mercancías. |
AnioEmbarcacion | Numerico | Opcional | Atributo opcional para registrar el año de la embarcación en la que se transportan los bienes y/o mercancías. |
NombreEmbarc | String | Opcional | Atributo opcional para registrar el nombre de la embarcación en la que se realiza el traslado de los bienes y/o mercancías. |
NacionalidadEmbarc | String | Requerido | Atributo requerido para registrar la clave del país correspondiente a la nacionalidad de la embarcación que transporta los bienes y/o mercancías. |
UnidadesDeArqBruto | Numerico | Requerido | Atributo requerido para registrar el valor de las unidades de arqueo bruto conforme a las medidas internacionales definidas por el ITC para cada tipo de buque o embarcación en la que se transportan los bienes y/o mercancías. |
TipoCarga | String | Requerido | Atributo requerido para especificar el tipo de carga en el cual se clasifican los bienes y/o mercancías que se transportan en la embarcación. |
Eslora | Numerico | Opcional | Atributo opcional para registrar la longitud de eslora, definida en pies, con la que cuenta la embarcación o el buque en el que se transportan los bienes y/o mercancías. |
Manga | Numerico | Opcional | Atributo opcional para registrar la longitud de manga, definida en pies, con la que cuenta la embarcación o el buque en el que se transportan los bienes y/o mercancías. |
Calado | Numerico | Opcional | Atributo opcional para registrar la longitud del calado, definida en pies, con la que cuenta la embarcación o el buque en el que se transportan los bienes y/o mercancías. |
Puntal nuevo | Numerico | Opcional | Atributo opcional para registrar la longitud del puntal, definida en pies, con la que cuenta la embarcación o el buque en el que se transportan los bienes y/o mercancías. |
LineaNaviera | String | Opcional | Atributo opcional para registrar el nombre de la línea naviera autorizada de gestionar el traslado de los bienes y/o mercancías por vía marítima. |
NombreAgenteNaviero | String | Requerido | Atributo requerido para registrar el nombre del agente naviero consignatario autorizado para gestionar el traslado de los bienes y/o mercancías por vía marítima. |
NumAutorizacionNaviero | String | Requerido | Atributo requerido para expresar el número de la autorización como agente naviero consignatario emitida por la autoridad correspondiente. |
NumViaje | String | Opcional | Atributo opcional para registrar el número del viaje con el que se identifica el traslado de los bienes y/o mercancías en el buque o la embarcación. |
NumConocEmbarc | String | Opcional | Atributo opcional para registrar el número de conocimiento de embarque con el que se identifica el traslado de los bienes y/o mercancías. |
PermisoTempNavegacion nuevo | String | Opcional | Atributo condicional para registrar el permiso temporal de navegación de la embarcación o buque que transporta los bienes y/o mercancías. |
Contenedor | Arreglo | Opcional | Nodo opcional para registrar los datos del contenedor en el que se transportan los bienes y/o mercancías. |
RemolquesCCP | Arreglo | Opcional | Nodo condicional para registrar los datos del(los) remolque(s) o semirremolque(s) que se adaptan al autotransporte que realizó el traslado de los bienes y/o mercancías registrado en el CFDI con complemento Carta Porte de autotransporte, únicamente aplica para traslado mediante ferri. |
Contenedor
Nodo: Contenedor (CartaPorte → Mercancias → TransporteMaritimo → Contenedor) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
TipoContenedor | String | Requerido | Atributo requerido para registrar la clave de identificación correspondiente con el tipo de contenedor marítimo en el que se transportan los bienes y/o mercancías. |
MatriculaContenedor | String | Opcional | Atributo condicional para registrar la matrícula o el número de identificación del contenedor marítimo en el que se transportan los bienes y/o mercancías, el cual está integrado por el código del propietario, el número de serie y el dígito de control correspondiente. |
NumPrecinto | String | Opcional | Atributo condicional para registrar el número del sello o precinto de los contenedores marítimos que son utilizados para trasladar los bienes y/o mercancías. |
IdCCPRelacionado nuevo | String | Opcional | Atributo condicional para registrar el identificador del complemento Carta Porte (IdCCP) de un CFDI previamente certificado para el traslado de bienes o mercancías mediante autotransporte, únicamente aplica para traslados mediante ferri. |
PlacaVMCCP nuevo | String | Opcional | Atributo condicional para registrar los caracteres alfanuméricos, sin guiones ni espacios de la placa vehicular del autotransporte registrado en el CFDI con complemento Carta Porte del autotransporte, únicamente aplica para traslado mediante ferri. |
FechaCertificacionCPP nuevo | String | Opcional | Atributo condicional para registrar la fecha y hora de certificación del CDFI con complemento Carta Porte del autotransporte, únicamente aplica para traslado mediante ferri. |
RemolquesCCP
nuevo 3.1
Tip
Este nodo presenta cambios con respecto a la versión 3.0 de carta porte, anteriormente se encontraba en el mismo nivel de indexación que el nodo Contenedor, en esta actualización su nueva ubicacion es dentro del nodo Contenedor y mantiene las mismas propiedades para todos sus elementos.
Nodo: RemolquesCPP (CartaPorte → Mercancias → TransporteMaritimo → Contenedor → RemolquesCPP) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
RemolqueCCP | Arreglo | Obligatorio | Nodo requerido para expresar la información del(los) remolque(s) o semirremolque(s) que se adapta(n) al autotransporte que realizó el traslado de los bienes y/o mercancías registrado en el CFDI con complemento Carta Porte, únicamente aplica para traslado mediante ferri. |
RemolqueCCP
nuevo 3.1
Nodo: RemolqueCCP (CartaPorte → Mercancias → TransporteMaritimo → Contenedor → RemolquesCPP→ RemolqueCCP) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
SubtipoRemCCP | String | Requerido | Atributo requerido para expresar la clave del subtipo de remolque o semirremolques que se emplean con el autotransporte que realizó el traslado de los bienes y/o mercancías registrado en el CFDI con complemento Carta Porte, únicamente aplica para traslado mediante ferri. |
PlacaCCP | String | Requerido | Atributo requerido para registrar los caracteres alfanuméricos, sin guiones ni espacios de la placa vehicular del autotransporte registrado en el CFDI con complemento Carta Porte, únicamente aplica para traslado mediante ferri. |
TransporteAereo
Nodo: TransporteAereo (CartaPorte → Mercancias → TransporteAereo) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
PermSCT | String | Requerido | Atributo requerido para registrar la clave del permiso proporcionado por la Secretaría de Infraestructura, Comunicaciones y Transportes (SICT), o la autoridad análoga, la cual debe corresponder con la aeronave que se está utilizando para realizar el traslado de los bienes y/o mercancías por vía aérea. |
NumPermisoSCT | String | Requerido | Atributo requerido para registrar el número de permiso o valor análogo proporcionado por la Secretaría de Infraestructura, Comunicaciones y Transportes (SICT), o la autoridad análoga, según corresponda, para el transporte de bienes y/o mercancías por vía aérea. |
MatriculaAeronave | String | Opcional | Atributo opcional para registrar el número de la matrícula de la aeronave con la que se realiza el traslado de los bienes y/o mercancías en territorio nacional el cual tiene una longitud de 10 posiciones y se compone de valores alfanuméricos, más el carácter especial denominado guion medio “-“. Patrón: ([A-Z]|[0-9]|-){5,11} |
NombreAseg | String | Opcional | Atributo opcional para registrar el nombre de la aseguradora que cubre los riesgos de la aeronave con la que transportan los bienes y/o mercancías. |
NumPolizaSeguro | String | Opcional | Atributo opcional para registrar el número de póliza asignado por la aseguradora que cubre la protección e indemnización por responsabilidad civil de la aeronave que transporta los bienes y/o mercancías. |
NumeroGuia | String | Requerido | Atributo requerido para registrar el número de guía aérea con el que se trasladan los bienes y/o mercancías. |
LugarContrato | String | Opcional | Atributo opcional para registrar el lugar, entidad, región, localidad o análogo, donde se celebró el contrato para realizar el traslado de los bienes y/o mercancías. |
CodigoTransportista | String | Requerido | Atributo requerido para registrar el valor del código que tiene asignado el transportista el cual debe contener alguna de las claves contenidas en el catálogo correspondiente. |
RFCEmbarcador | String | Opcional | Atributo opcional para registrar el RFC del embarcador de los bienes y/o mercancías que se trasladan. |
NumRegIdTribEmbarc | String | Opcional | Atributo condicional para incorporar el número de identificación o registro fiscal del país de residencia cuando el embarcador sea residente en el extranjero para los efectos fiscales correspondientes de los bienes y/o mercancías que se trasladan. |
ResidenciaFiscalEmbarc | String | Opcional | Atributo condicional para registrar la clave del país de residencia para efectos fiscales del embarcador de los bienes y/o mercancías. |
NombreEmbarcador | String | Opcional | Atributo opcional para registrar el nombre del embarcador de los bienes y/o mercancías que se trasladan, ya sea nacional o extranjero. |
TransporteFerroviario
Nodo: TransporteFerroviario (CartaPorte → Mercancias → TransporteFerroviario) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
TipoDeServicio | String | Requerido | Atributo requerido para registrar la clave del tipo de servicio utilizado para el traslado de los bienes y/o mercancías por vía férrea. |
TipoDeTrafico | String | Requerido | Atributo requerido para registrar la clave del tipo de tráfico (interrelación entre concesionarios) para realizar el traslado de los bienes y/o mercancías por vía férrea dentro del territorio nacional. |
NombreAseg | String | Opcional | Atributo opcional para registrar el nombre de la aseguradora que cubre los riesgos para el traslado de los bienes y/o mercancías por vía férrea. |
NumPolizaSeguro | String | Opcional | Atributo opcional para registrar el número de póliza asignada por la aseguradora para la protección e indemnización por responsabilidad civil en el traslado de los bienes y/o mercancías que se realiza por vía férrea. |
DerechosDePaso | Arreglo | Opcional | Nodo opcional para registrar los tipos de derechos de paso cubiertos por el transportista en las vías férreas de las cuales no es concesionario o asignatario, así como la distancia establecida en kilómetros. |
Carro | Arreglo | Requerido | Nodo requerido para registrar la información que permite identificar el (los) carro(s) en el (los) que se trasladan los bienes y/o mercancías por vía férrea. |
DerechosDePaso
Nodo: DerechosDePaso (CartaPorte → Mercancias → TransporteFerroviario → DerechosDePaso) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
TipoDerechoDePaso | String | Requerido | Atributo requerido para registrar la clave del derecho de paso pagado por el transportista en las vías férreas de las cuales no es concesionario o asignatario. |
KilometrajePagado | Numerico | Requerido | Atributo requerido para registrar el total de kilómetros pagados por el transportista en las vías férreas de las cuales no es concesionario o asignatario con el derecho de paso. |
Carro
Nodo: Carro (CartaPorte → Mercancias → TransporteFerroviario → Carro) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
TipoCarro | String | Requerido | Atributo requerido para registrar la clave del tipo de carro utilizado para el traslado de los bienes y/o mercancías por vía férrea. |
MatriculaCarro | String | Requerido | Atributo requerido para registrar el número de contenedor, carro de ferrocarril o número económico del vehículo en el que se trasladan los bienes y/o mercancías por vía férrea. |
GuiaCarro | String | Requerido | Atributo requerido para registrar el número de guía asignado al contenedor, carro de ferrocarril o vehículo, en el que se trasladan los bienes y/o mercancías por vía férrea. |
ToneladasNetasCarro | Numerico | Requerido | Atributo requerido para registrar la cantidad de las toneladas netas depositadas en el contenedor, carro de ferrocarril o vehículo en el que se trasladan los bienes y/o mercancías por vía férrea. |
Contenedor | Arreglo | Opcional | Nodo condicional para especificar el tipo de contenedor o vagón en el que se trasladan los bienes y/o mercancías por vía férrea. |
Contenedor
Nodo: Contenedor (CartaPorte → Mercancias → TransporteFerroviario → Carro → Contenedor) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
TipoContenedor | String | Requerido | Atributo requerido para registrar la clave con la que se identifica al tipo de contenedor o el vagón en el que se realiza el traslado de los bienes y/o mercancías. |
PesoContenedorVacio | Numerico | Requerido | Atributo requerido para registrar en kilogramos, el peso del contenedor vacío en el que se trasladan los bienes y/o mercancías. |
PesoNetoMercancia | Numerico | Requerido | Atributo requerido para registrar en kilogramos el peso neto de los bienes y/o mercancías que son trasladados en el contenedor |
FiguraTransporte
Nodo: FiguraTransporte (CartaPorte → FiguraTransporte) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
TiposFigura | Arreglo | Requerido | Nodo condicional para indicar los datos del(los) tipo(s) de figura(s) que participan en el traslado de los bienes y/o mercancías en los distintos medios de transporte. |
TiposFigura
Nodo: TiposFigura (CartaPorte → FiguraTransporte → TiposFigura) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
TipoFigura | String | Requerido | Atributo requerido para registrar la clave de la figura de transporte que interviene en el traslado de los bienes y/o mercancías. |
RFCFigura | String | Opcional | Atributo condicional para registrar el RFC de la figura de transporte que interviene en el traslado de los bienes y/o mercancías. |
NumLicencia | String | Opcional | Atributo condicional para expresar el número de la licencia o el permiso otorgado al operador del autotransporte de carga en el que realiza el traslado de los bienes y/o mercancías. |
NombreFigura | String | Requerido | Atributo requerido para registrar el nombre de la figura de transporte que interviene en el traslado de los bienes y/o mercancías. |
NumRegIdTribFigura | String | Opcional | Atributo condicional para registrar el número de identificación o registro fiscal del país de residencia de la figura de transporte que interviene en el traslado de los bienes y/o mercancías, cuando se trate de residentes en el extranjero para los efectos fiscales correspondientes. |
ResidenciaFiscalFigura | String | Opcional | Atributo condicional para registrar la clave del país de residencia de la figura de transporte que interviene en el traslado de los bienes y/o mercancías para los efectos fiscales correspondientes. |
PartesTransporte | Arreglo | Opcional | Nodo condicional para indicar los datos de las partes del transporte de las cuales el emisor del comprobante es distinto al dueño de las mismas, por ejemplo: vehículos, máquinas, contenedores, plataformas, entre otros, etc; mismos que son utilizados para el traslado de los bienes y/o mercancías. |
Domicilio | Arreglo | Opcional | Nodo opcional para registrar información del domicilio del(los) tipo(s) de figura transporte que intervenga(n) en el traslado de los bienes y/o mercancías. |
PartesTransporte
Nodo: PartesTransporte (CartaPorte → FiguraTransporte → TiposFigura → PartesTransporte) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
ParteTransporte | String | Requerido | Atributo requerido para registrar información de la parte del transporte de la cual el emisor del comprobante es distinto al dueño de la misma, por ejemplo: vehículos, máquinas, contenedores, plataformas, etc; que se utilicen para el traslado de los bienes y/o mercancías. |
Domicilio
Nodo: Domicilio (CartaPorte → FiguraTransporte → TiposFigura → Domicilio) | |||
---|---|---|---|
Parámetro | Tipo | Requerido | Detalles |
Calle | String | Opcional | Atributo opcional para registrar la calle en la que está ubicado el domicilio de origen y/o destino de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. |
NumeroExterior | String | Opcional | Atributo opcional que sirve para registrar el número exterior del domicilio de origen y/o destino de los bienes y/o mercancías que se trasladan en los distintos medios del transporte. |
NumeroInterior | String | Opcional | Atributo opcional que sirve para registrar el número interior, en caso de existir, del domicilio de origen y/o destino de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. |
Colonia | String | Opcional | Atributo opcional que sirve para registrar la clave de la colonia o dato análogo, del domicilio de origen y/o destino de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. |
Localidad | String | Opcional | Atributo opcional que sirve para registrar la ciudad, población, o dato análogo del domicilio de origen y/o destino de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. |
Referencia | String | Opcional | Atributo opcional para registrar una referencia geográfica adicional que permita una fácil o precisa ubicación del domicilio de origen y/o destino de los bienes y/o mercancías que se trasladan en los distintos medios de transporte; por ejemplo, las coordenadas del GPS. |
Municipio | String | Opcional | Atributo opcional que sirve para registrar el municipio, delegación o alcaldía, condado o dato análogo del domicilio de origen y/o destino de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. |
Estado | String | Requerido | Atributo requerido para registrar el estado, entidad, región, comunidad, o dato análogo en donde se encuentra ubicado el domicilio del origen y/o destino de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. |
Pais | String | Requerido | Atributo requerido que sirve para registrar la clave del país en donde se encuentra ubicado el domicilio del origen y/o destino de los bienes y/o mercancías que se trasladan en los distintos medios de transporte, conforme con el catálogo de c_Pais del CFDI, publicado en el portal del SAT en Internet de acuerdo a la especificación ISO 3166-1. |
CodigoPostal | String | Requerido | Atributo requerido para registrar el código postal en donde se encuentra el domicilio del origen y/o destino de los bienes y/o mercancías que se trasladan en los distintos medios de transporte. |
Tipos de Carta Porte
Tip
Existen dos diferentes tipos de Carta Porte "Ingreso" y "Traslado" es importante definir el tipo de documento que estamos utilizando al crear nuestra Carta Porte y utilizar la serie correspondiente mas delante se especifica como diferenciar el tipo de documento
Adicional a esto, la información requerida de este complemento puede variar según el tipo de documento.
Clave | Tipo de CFDI |
---|---|
carta_porte_ingreso | Ingreso (Carta Porte) |
carta_porte | Traslado (Carta Porte) |
CFDI de Ingreso
Para crear un CFDI de ingreso debemos enviar el parametro como aparece a continuación:
TipoDocumento": "carta_porte_ingreso"
Importante
Es importante seleccionar una serie destinada para este documento para poder timbrar nuestra Carta Porte y en caso de no contar con una serie para este documento deberemos crear una nueva serie con el tipo de documento: "carta_porte_ingreso"
Puedes consultar como crear una nueva serie en este link.
Construcción de la URL
Host: https://facturaonline.com.mx/api (producción) / https://sandbox.facturaonline.com.mx/api (sandbox)
Endpoint: /v4/cfdi40/create
Ejemplo: https://facturaonline.com.mx/api/v4/cfdi40/create
Tip
Para probar el ejemplo de código, necesitas cambiar "Tu API key" por la clave de API de tu cuenta, y "Tu Secret key" por la clave secreta correspondiente.
Importante
Dependiendo el transporte que se utilizara para trasladar la mercancía se proporciona una guía de llenado destinada a los siguientes tipos: Autotransporte, Marítimo, Aéreo o Ferroviario
Para Autotransporte corresponde la siguiente guía:
Instructivo_Carta_Porte_Autotransporte.pdf
Para transporte Marítimo corresponde la siguiente guía:
Instructivo_Carta_Porte_Maritimo.pdf
Para transporte Aéreo corresponde la siguiente guía:
Instructivo_Carta_Porte_Aereo.pdf
Para transporte Ferroviario corresponde la siguiente guía:
Instructivo_Carta_Porte_Ferroviario.pdf
Ejemplo de CFDI de ingreso
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => '{ HOST }/v4/cfdi40/create',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"Receptor": {
"UID": "63ebd090d6015"
},
"TipoDocumento": "carta_porte_ingreso",
"RegimenFiscal": "606",
"UsoCFDI": "S01",
"Redondeo": "2",
"Conceptos": [
{
"ClaveProdServ": "78101800",
"Cantidad": "1.00",
"ClaveUnidad": "E48",
"Unidad": "Unidad de servicio",
"Descripcion": "SERVICIO DE FLETE NACAJUCA 1 A 5 REPARTOS NO. DE TRANSPORTE 289822 NO. DE RUTA 310753 SALIO DE CEDIS IXTACOMITAN UNIDAD 3.5 TONELADAS",
"ValorUnitario": "2200.00",
"Importe": "2200",
"Impuestos": {
"Traslados": [
{
"Base": "2200",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.16",
"Importe": "352"
}
],
"Retenidos": [
{
"Base": "2200",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.04",
"Importe": "88"
}
]
}
}
],
"FormaPago": "99",
"MetodoPago": "PPD",
"Moneda": "MXN",
"Serie": "50450",
"CartaPorte": {
"Version": "3.1",
"IdCCP": "CCCDA373-FB1A-44AE-83A2-448B0865BDA3",
"TranspInternac": "No",
"TotalDistRec": "300",
"Ubicaciones": {
"Ubicacion": [
{
"IDUbicacion": "OR123456",
"FechaHoraSalidaLlegada": "2023-10-05T07:00:00",
"RFCRemitenteDestinatario": "TPM9809038X0",
"NombreRemitenteDestinatario": "THYSSENKRUPP PRESTA DE MEXICO, S.A. DE C.V. PM1",
"TipoUbicacion": "Origen",
"Domicilio": {
"Calle": "Calle Circuito Esteban de Antuñano",
"Estado": "PUE",
"Pais": "MEX",
"CodigoPostal": "74160",
"Colonia": "1500",
"Municipio": "074"
}
},
{
"IDUbicacion": "DE654321",
"DistanciaRecorrida": "300",
"FechaHoraSalidaLlegada": "2023-10-05T13:50:00",
"RFCRemitenteDestinatario": "STE071214BE7",
"NombreRemitenteDestinatario": "Nexteer PLANTA 69",
"TipoUbicacion": "Destino",
"Domicilio": {
"Calle": "",
"Estado": "QUE",
"Pais": "MEX",
"CodigoPostal": "76246",
"Colonia": "0001",
"Municipio": "011"
}
}
]
},
"Mercancias": {
"Mercancia": [
{
"PesoEnKg": "723",
"Cantidad": "4224",
"BienesTransp": "25174200",
"ClaveUnidad": "H87",
"Descripcion": "Sistema de dirección",
"FraccionArancelaria": "",
"UUIDComercioExt": "",
"CantidadTransporta": [{
"Cantidad": "4224",
"IDOrigen": "OR123456",
"IDDestino": "DE654321"
}]
}
],
"Autotransporte": {
"NumPermisoSCT": "9639934",
"PermSCT": "TPAF01",
"IdentificacionVehicular": {
"AnioModeloVM": "2023",
"PesoBrutoVehicular": "200",
"ConfigVehicular": "VL",
"PlacaVM": "99AX7H"
},
"Seguros": {
"AseguraRespCivil": "BANORTE",
"PolizaRespCivil": "4111867"
}
},
"NumTotalMercancias": "1",
"PesoBrutoTotal": "723",
"UnidadPeso": "KGM"
},
"FiguraTransporte": {
"TiposFigura": [
{
"Domicilio": {
"Calle": "",
"NumeroInterior": "",
"Colonia": "",
"Localidad": "03",
"Municipio": "009",
"Estado": "COL",
"Pais": "MEX",
"CodigoPostal": "28934"
},
"TipoFigura": "01",
"RFCFigura": "CALJ741208LN5",
"NumLicencia": "PUE0011259",
"NombreFigura": "JUAN RENE CARRASCO LIZANA"
}
]
}
}
} ',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json',
'F-PLUGIN: 9d4095c8f7ed5785cb14c0e3b033eeb8252416ed',
'F-Api-Key: Tu API key',
'F-Secret-Key: Tu Secret key'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
var request = require('request');
var options = {
'method': 'POST',
'url': '{ HOST }/v4/cfdi40/create',
'headers': {
'Content-Type': 'application/json',
'F-PLUGIN': '9d4095c8f7ed5785cb14c0e3b033eeb8252416ed',
'F-Api-Key': 'Tu API key',
'F-Secret-Key': 'Tu Secret key'
},
body: JSON.stringify({
"Receptor": {
"UID": "63ebd090d6015"
},
"TipoDocumento": "carta_porte_ingreso",
"RegimenFiscal": "606",
"UsoCFDI": "S01",
"Redondeo": "2",
"Conceptos": [
{
"ClaveProdServ": "78101800",
"Cantidad": "1.00",
"ClaveUnidad": "E48",
"Unidad": "Unidad de servicio",
"Descripcion": "SERVICIO DE FLETE NACAJUCA 1 A 5 REPARTOS NO. DE TRANSPORTE 289822 NO. DE RUTA 310753 SALIO DE CEDIS IXTACOMITAN UNIDAD 3.5 TONELADAS",
"ValorUnitario": "2200.00",
"Importe": "2200",
"Impuestos": {
"Traslados": [
{
"Base": "2200",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.16",
"Importe": "352"
}
],
"Retenidos": [
{
"Base": "2200",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.04",
"Importe": "88"
}
]
}
}
],
"FormaPago": "99",
"MetodoPago": "PPD",
"Moneda": "MXN",
"Serie": "50450",
"CartaPorte": {
"Version": "3.1",
"IdCCP": "CCCDA373-FB1A-44AE-83A2-448B0865BDA3",
"TranspInternac": "No",
"TotalDistRec": "300",
"Ubicaciones": {
"Ubicacion": [
{
"IDUbicacion": "OR123456",
"FechaHoraSalidaLlegada": "2023-10-05T07:00:00",
"RFCRemitenteDestinatario": "TPM9809038X0",
"NombreRemitenteDestinatario": "THYSSENKRUPP PRESTA DE MEXICO, S.A. DE C.V. PM1",
"TipoUbicacion": "Origen",
"Domicilio": {
"Calle": "Calle Circuito Esteban de Antuñano",
"Estado": "PUE",
"Pais": "MEX",
"CodigoPostal": "74160",
"Colonia": "1500",
"Municipio": "074"
}
},
{
"IDUbicacion": "DE654321",
"DistanciaRecorrida": "300",
"FechaHoraSalidaLlegada": "2023-10-05T13:50:00",
"RFCRemitenteDestinatario": "STE071214BE7",
"NombreRemitenteDestinatario": "Nexteer PLANTA 69",
"TipoUbicacion": "Destino",
"Domicilio": {
"Calle": "",
"Estado": "QUE",
"Pais": "MEX",
"CodigoPostal": "76246",
"Colonia": "0001",
"Municipio": "011"
}
}
]
},
"Mercancias": {
"Mercancia": [
{
"PesoEnKg": "723",
"Cantidad": "4224",
"BienesTransp": "25174200",
"ClaveUnidad": "H87",
"Descripcion": "Sistema de dirección",
"FraccionArancelaria": "",
"UUIDComercioExt": "",
"CantidadTransporta": [
{
"Cantidad": "4224",
"IDOrigen": "OR123456",
"IDDestino": "DE654321"
}
]
}
],
"Autotransporte": {
"NumPermisoSCT": "9639934",
"PermSCT": "TPAF01",
"IdentificacionVehicular": {
"AnioModeloVM": "2023",
"PesoBrutoVehicular": "200",
"ConfigVehicular": "VL",
"PlacaVM": "99AX7H"
},
"Seguros": {
"AseguraRespCivil": "BANORTE",
"PolizaRespCivil": "4111867"
}
},
"NumTotalMercancias": "1",
"PesoBrutoTotal": "723",
"UnidadPeso": "KGM"
},
"FiguraTransporte": {
"TiposFigura": [
{
"Domicilio": {
"Calle": "",
"NumeroInterior": "",
"Colonia": "",
"Localidad": "03",
"Municipio": "009",
"Estado": "COL",
"Pais": "MEX",
"CodigoPostal": "28934"
},
"TipoFigura": "01",
"RFCFigura": "CALJ741208LN5",
"NumLicencia": "PUE0011259",
"NombreFigura": "JUAN RENE CARRASCO LIZANA"
}
]
}
}
})
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
import requests
import json
url = "{ HOST }/v4/cfdi40/create"
payload = json.dumps({
"Receptor": {
"UID": "63ebd090d6015"
},
"TipoDocumento": "carta_porte_ingreso",
"RegimenFiscal": "606",
"UsoCFDI": "S01",
"Redondeo": "2",
"Conceptos": [
{
"ClaveProdServ": "78101800",
"Cantidad": "1.00",
"ClaveUnidad": "E48",
"Unidad": "Unidad de servicio",
"Descripcion": "SERVICIO DE FLETE NACAJUCA 1 A 5 REPARTOS NO. DE TRANSPORTE 289822 NO. DE RUTA 310753 SALIO DE CEDIS IXTACOMITAN UNIDAD 3.5 TONELADAS",
"ValorUnitario": "2200.00",
"Importe": "2200",
"Impuestos": {
"Traslados": [
{
"Base": "2200",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.16",
"Importe": "352"
}
],
"Retenidos": [
{
"Base": "2200",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.04",
"Importe": "88"
}
]
}
}
],
"FormaPago": "99",
"MetodoPago": "PPD",
"Moneda": "MXN",
"Serie": "50450",
"CartaPorte": {
"Version": "3.1",
"IdCCP": "CCCDA373-FB1A-44AE-83A2-448B0865BDA3",
"TranspInternac": "No",
"TotalDistRec": "300",
"Ubicaciones": {
"Ubicacion": [
{
"IDUbicacion": "OR123456",
"FechaHoraSalidaLlegada": "2023-10-05T07:00:00",
"RFCRemitenteDestinatario": "TPM9809038X0",
"NombreRemitenteDestinatario": "THYSSENKRUPP PRESTA DE MEXICO, S.A. DE C.V. PM1",
"TipoUbicacion": "Origen",
"Domicilio": {
"Calle": "Calle Circuito Esteban de Antuñano",
"Estado": "PUE",
"Pais": "MEX",
"CodigoPostal": "74160",
"Colonia": "1500",
"Municipio": "074"
}
},
{
"IDUbicacion": "DE654321",
"DistanciaRecorrida": "300",
"FechaHoraSalidaLlegada": "2023-10-05T13:50:00",
"RFCRemitenteDestinatario": "STE071214BE7",
"NombreRemitenteDestinatario": "Nexteer PLANTA 69",
"TipoUbicacion": "Destino",
"Domicilio": {
"Calle": "",
"Estado": "QUE",
"Pais": "MEX",
"CodigoPostal": "76246",
"Colonia": "0001",
"Municipio": "011"
}
}
]
},
"Mercancias": {
"Mercancia": [
{
"PesoEnKg": "723",
"Cantidad": "4224",
"BienesTransp": "25174200",
"ClaveUnidad": "H87",
"Descripcion": "Sistema de dirección",
"FraccionArancelaria": "",
"UUIDComercioExt": "",
"CantidadTransporta": [
{
"Cantidad": "4224",
"IDOrigen": "OR123456",
"IDDestino": "DE654321"
}
]
}
],
"Autotransporte": {
"NumPermisoSCT": "9639934",
"PermSCT": "TPAF01",
"IdentificacionVehicular": {
"AnioModeloVM": "2023",
"PesoBrutoVehicular": "200",
"ConfigVehicular": "VL",
"PlacaVM": "99AX7H"
},
"Seguros": {
"AseguraRespCivil": "BANORTE",
"PolizaRespCivil": "4111867"
}
},
"NumTotalMercancias": "1",
"PesoBrutoTotal": "723",
"UnidadPeso": "KGM"
},
"FiguraTransporte": {
"TiposFigura": [
{
"Domicilio": {
"Calle": "",
"NumeroInterior": "",
"Colonia": "",
"Localidad": "03",
"Municipio": "009",
"Estado": "COL",
"Pais": "MEX",
"CodigoPostal": "28934"
},
"TipoFigura": "01",
"RFCFigura": "CALJ741208LN5",
"NumLicencia": "PUE0011259",
"NombreFigura": "JUAN RENE CARRASCO LIZANA"
}
]
}
}
})
headers = {
'Content-Type': 'application/json',
'F-PLUGIN': '9d4095c8f7ed5785cb14c0e3b033eeb8252416ed',
'F-Api-Key': 'Tu API key',
'F-Secret-Key': 'Tu Secret key'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
require "uri"
require "json"
require "net/http"
url = URI("{ HOST }/v4/cfdi40/create")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request["F-PLUGIN"] = "9d4095c8f7ed5785cb14c0e3b033eeb8252416ed"
request["F-Api-Key"] = "Tu API key"
request["F-Secret-Key"] = "Tu Secret key"
request.body = JSON.dump({
"Receptor": {
"UID": "63ebd090d6015"
},
"TipoDocumento": "carta_porte_ingreso",
"RegimenFiscal": "606",
"UsoCFDI": "S01",
"Redondeo": "2",
"Conceptos": [
{
"ClaveProdServ": "78101800",
"Cantidad": "1.00",
"ClaveUnidad": "E48",
"Unidad": "Unidad de servicio",
"Descripcion": "SERVICIO DE FLETE NACAJUCA 1 A 5 REPARTOS NO. DE TRANSPORTE 289822 NO. DE RUTA 310753 SALIO DE CEDIS IXTACOMITAN UNIDAD 3.5 TONELADAS",
"ValorUnitario": "2200.00",
"Importe": "2200",
"Impuestos": {
"Traslados": [
{
"Base": "2200",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.16",
"Importe": "352"
}
],
"Retenidos": [
{
"Base": "2200",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.04",
"Importe": "88"
}
]
}
}
],
"FormaPago": "99",
"MetodoPago": "PPD",
"Moneda": "MXN",
"Serie": "50450",
"CartaPorte": {
"Version": "3.1",
"IdCCP": "CCCDA373-FB1A-44AE-83A2-448B0865BDA3",
"TranspInternac": "No",
"TotalDistRec": "300",
"Ubicaciones": {
"Ubicacion": [
{
"IDUbicacion": "OR123456",
"FechaHoraSalidaLlegada": "2023-10-05T07:00:00",
"RFCRemitenteDestinatario": "TPM9809038X0",
"NombreRemitenteDestinatario": "THYSSENKRUPP PRESTA DE MEXICO, S.A. DE C.V. PM1",
"TipoUbicacion": "Origen",
"Domicilio": {
"Calle": "Calle Circuito Esteban de Antuñano",
"Estado": "PUE",
"Pais": "MEX",
"CodigoPostal": "74160",
"Colonia": "1500",
"Municipio": "074"
}
},
{
"IDUbicacion": "DE654321",
"DistanciaRecorrida": "300",
"FechaHoraSalidaLlegada": "2023-10-05T13:50:00",
"RFCRemitenteDestinatario": "STE071214BE7",
"NombreRemitenteDestinatario": "Nexteer PLANTA 69",
"TipoUbicacion": "Destino",
"Domicilio": {
"Calle": "",
"Estado": "QUE",
"Pais": "MEX",
"CodigoPostal": "76246",
"Colonia": "0001",
"Municipio": "011"
}
}
]
},
"Mercancias": {
"Mercancia": [
{
"PesoEnKg": "723",
"Cantidad": "4224",
"BienesTransp": "25174200",
"ClaveUnidad": "H87",
"Descripcion": "Sistema de dirección",
"FraccionArancelaria": "",
"UUIDComercioExt": "",
"CantidadTransporta": [
{
"Cantidad": "4224",
"IDOrigen": "OR123456",
"IDDestino": "DE654321"
}
]
}
],
"Autotransporte": {
"NumPermisoSCT": "9639934",
"PermSCT": "TPAF01",
"IdentificacionVehicular": {
"AnioModeloVM": "2023",
"PesoBrutoVehicular": "200",
"ConfigVehicular": "VL",
"PlacaVM": "99AX7H"
},
"Seguros": {
"AseguraRespCivil": "BANORTE",
"PolizaRespCivil": "4111867"
}
},
"NumTotalMercancias": "1",
"PesoBrutoTotal": "723",
"UnidadPeso": "KGM"
},
"FiguraTransporte": {
"TiposFigura": [
{
"Domicilio": {
"Calle": "",
"NumeroInterior": "",
"Colonia": "",
"Localidad": "03",
"Municipio": "009",
"Estado": "COL",
"Pais": "MEX",
"CodigoPostal": "28934"
},
"TipoFigura": "01",
"RFCFigura": "CALJ741208LN5",
"NumLicencia": "PUE0011259",
"NombreFigura": "JUAN RENE CARRASCO LIZANA"
}
]
}
}
})
response = https.request(request)
puts response.read_body
CFDI de Traslado
Para crear un CFDI de traslado debemos enviar el parametro como aparece a continuación:
"TipoDocumento": "carta_porte"
Importante
Es importante seleccionar una serie destinada para este documento para poder timbrar nuestra Carta Porte y en caso de no contar con una serie para este documento deberemos crear una nueva serie con el tipo de documento: "carta_porte"
Puedes consultar como crear una nueva serie en el siguiente link.
Construcción de la URL
Host: https://facturaonline.com.mx/api (producción) / https://sandbox.facturaonline.com.mx/api (sandbox)
Endpoint: /v4/cfdi40/create
Ejemplo: https://facturaonline.com.mx/api/v4/cfdi40/create
Tip
Para probar el ejemplo de código, necesitas cambiar "Tu API key" por la clave de API de tu cuenta, y "Tu Secret key" por la clave secreta correspondiente.
Importante
Dependiendo el transporte que se utilizara para trasladar la mercancía se proporciona una guía de llenado destinada a los siguientes tipos: Autotransporte, Marítimo, Aéreo o Ferroviario
Para Autotransporte corresponde la siguiente guía:
Instructivo_Carta_Porte_Autotransporte.pdf
Para transporte Marítimo corresponde la siguiente guía:
Instructivo_Carta_Porte_Maritimo.pdf
Para transporte Aéreo corresponde la siguiente guía:
Instructivo_Carta_Porte_Aereo.pdf
Para transporte Ferroviario corresponde la siguiente guía:
Instructivo_Carta_Porte_Ferroviario.pdf
Ejemplo de cfdi de traslado
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => '{ HOST }/v4/cfdi40/create',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"Receptor": {
"UID": "63ebd090d6015"
},
"TipoDocumento": "carta_porte",
"RegimenFiscal": "606",
"UsoCFDI": "S01",
"Redondeo": "2",
"Conceptos": [
{
"ClaveProdServ": "78101800",
"Cantidad": "1.00",
"ClaveUnidad": "E48",
"Unidad": "Unidad de servicio",
"Descripcion": "SERVICIO DE FLETE NACAJUCA 1 A 5 REPARTOS NO. DE TRANSPORTE 289822 NO. DE RUTA 310753 SALIO DE CEDIS IXTACOMITAN UNIDAD 3.5 TONELADAS",
"ValorUnitario": "2200.00",
"Importe": "2200",
"Impuestos": {
"Traslados": [
{
"Base": "2200",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.16",
"Importe": "352"
}
],
"Retenidos": [
{
"Base": "2200",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.04",
"Importe": "88"
}
]
}
}
],
"FormaPago": "99",
"MetodoPago": "PPD",
"Moneda": "MXN",
"Serie": "50450",
"CartaPorte": {
"Version": "3.1",
"IdCCP": "CCCDA373-FB1A-44AE-83A2-448B0865BDA3",
"TranspInternac": "No",
"TotalDistRec": "300",
"Ubicaciones": {
"Ubicacion": [
{
"IDUbicacion": "OR123456",
"FechaHoraSalidaLlegada": "2023-10-05T07:00:00",
"RFCRemitenteDestinatario": "TPM9809038X0",
"NombreRemitenteDestinatario": "THYSSENKRUPP PRESTA DE MEXICO, S.A. DE C.V. PM1",
"TipoUbicacion": "Origen",
"Domicilio": {
"Calle": "Calle Circuito Esteban de Antuñano",
"Estado": "PUE",
"Pais": "MEX",
"CodigoPostal": "74160",
"Colonia": "1500",
"Municipio": "074"
}
},
{
"IDUbicacion": "DE654321",
"DistanciaRecorrida": "300",
"FechaHoraSalidaLlegada": "2023-10-05T13:50:00",
"RFCRemitenteDestinatario": "STE071214BE7",
"NombreRemitenteDestinatario": "Nexteer PLANTA 69",
"TipoUbicacion": "Destino",
"Domicilio": {
"Calle": "",
"Estado": "QUE",
"Pais": "MEX",
"CodigoPostal": "76246",
"Colonia": "0001",
"Municipio": "011"
}
}
]
},
"Mercancias": {
"Mercancia": [
{
"PesoEnKg": "723",
"Cantidad": "4224",
"BienesTransp": "25174200",
"ClaveUnidad": "H87",
"Descripcion": "Sistema de dirección",
"FraccionArancelaria": "",
"UUIDComercioExt": "",
"CantidadTransporta": [{
"Cantidad": "4224",
"IDOrigen": "OR123456",
"IDDestino": "DE654321"
}]
}
],
"Autotransporte": {
"NumPermisoSCT": "9639934",
"PermSCT": "TPAF01",
"IdentificacionVehicular": {
"AnioModeloVM": "2023",
"PesoBrutoVehicular": "200",
"ConfigVehicular": "VL",
"PlacaVM": "99AX7H"
},
"Seguros": {
"AseguraRespCivil": "BANORTE",
"PolizaRespCivil": "4111867"
}
},
"NumTotalMercancias": "1",
"PesoBrutoTotal": "723",
"UnidadPeso": "KGM"
},
"FiguraTransporte": {
"TiposFigura": [
{
"Domicilio": {
"Calle": "",
"NumeroInterior": "",
"Colonia": "",
"Localidad": "03",
"Municipio": "009",
"Estado": "COL",
"Pais": "MEX",
"CodigoPostal": "28934"
},
"TipoFigura": "01",
"RFCFigura": "CALJ741208LN5",
"NumLicencia": "PUE0011259",
"NombreFigura": "JUAN RENE CARRASCO LIZANA"
}
]
}
}
} ',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json',
'F-PLUGIN: 9d4095c8f7ed5785cb14c0e3b033eeb8252416ed',
'F-Api-Key: Tu API key',
'F-Secret-Key: Tu Secret key'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
var request = require('request');
var options = {
'method': 'POST',
'url': '{ HOST }/v4/cfdi40/create',
'headers': {
'Content-Type': 'application/json',
'F-PLUGIN': '9d4095c8f7ed5785cb14c0e3b033eeb8252416ed',
'F-Api-Key': 'Tu API key',
'F-Secret-Key': 'Tu Secret key'
},
body: JSON.stringify({
"Receptor": {
"UID": "63ebd090d6015"
},
"TipoDocumento": "carta_porte",
"RegimenFiscal": "606",
"UsoCFDI": "S01",
"Redondeo": "2",
"Conceptos": [
{
"ClaveProdServ": "78101800",
"Cantidad": "1.00",
"ClaveUnidad": "E48",
"Unidad": "Unidad de servicio",
"Descripcion": "SERVICIO DE FLETE NACAJUCA 1 A 5 REPARTOS NO. DE TRANSPORTE 289822 NO. DE RUTA 310753 SALIO DE CEDIS IXTACOMITAN UNIDAD 3.5 TONELADAS",
"ValorUnitario": "2200.00",
"Importe": "2200",
"Impuestos": {
"Traslados": [
{
"Base": "2200",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.16",
"Importe": "352"
}
],
"Retenidos": [
{
"Base": "2200",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.04",
"Importe": "88"
}
]
}
}
],
"FormaPago": "99",
"MetodoPago": "PPD",
"Moneda": "MXN",
"Serie": "50450",
"CartaPorte": {
"Version": "3.1",
"IdCCP": "CCCDA373-FB1A-44AE-83A2-448B0865BDA3",
"TranspInternac": "No",
"TotalDistRec": "300",
"Ubicaciones": {
"Ubicacion": [
{
"IDUbicacion": "OR123456",
"FechaHoraSalidaLlegada": "2023-10-05T07:00:00",
"RFCRemitenteDestinatario": "TPM9809038X0",
"NombreRemitenteDestinatario": "THYSSENKRUPP PRESTA DE MEXICO, S.A. DE C.V. PM1",
"TipoUbicacion": "Origen",
"Domicilio": {
"Calle": "Calle Circuito Esteban de Antuñano",
"Estado": "PUE",
"Pais": "MEX",
"CodigoPostal": "74160",
"Colonia": "1500",
"Municipio": "074"
}
},
{
"IDUbicacion": "DE654321",
"DistanciaRecorrida": "300",
"FechaHoraSalidaLlegada": "2023-10-05T13:50:00",
"RFCRemitenteDestinatario": "STE071214BE7",
"NombreRemitenteDestinatario": "Nexteer PLANTA 69",
"TipoUbicacion": "Destino",
"Domicilio": {
"Calle": "",
"Estado": "QUE",
"Pais": "MEX",
"CodigoPostal": "76246",
"Colonia": "0001",
"Municipio": "011"
}
}
]
},
"Mercancias": {
"Mercancia": [
{
"PesoEnKg": "723",
"Cantidad": "4224",
"BienesTransp": "25174200",
"ClaveUnidad": "H87",
"Descripcion": "Sistema de dirección",
"FraccionArancelaria": "",
"UUIDComercioExt": "",
"CantidadTransporta": [
{
"Cantidad": "4224",
"IDOrigen": "OR123456",
"IDDestino": "DE654321"
}
]
}
],
"Autotransporte": {
"NumPermisoSCT": "9639934",
"PermSCT": "TPAF01",
"IdentificacionVehicular": {
"AnioModeloVM": "2023",
"PesoBrutoVehicular": "200",
"ConfigVehicular": "VL",
"PlacaVM": "99AX7H"
},
"Seguros": {
"AseguraRespCivil": "BANORTE",
"PolizaRespCivil": "4111867"
}
},
"NumTotalMercancias": "1",
"PesoBrutoTotal": "723",
"UnidadPeso": "KGM"
},
"FiguraTransporte": {
"TiposFigura": [
{
"Domicilio": {
"Calle": "",
"NumeroInterior": "",
"Colonia": "",
"Localidad": "03",
"Municipio": "009",
"Estado": "COL",
"Pais": "MEX",
"CodigoPostal": "28934"
},
"TipoFigura": "01",
"RFCFigura": "CALJ741208LN5",
"NumLicencia": "PUE0011259",
"NombreFigura": "JUAN RENE CARRASCO LIZANA"
}
]
}
}
})
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
import requests
import json
url = "{ HOST }/v4/cfdi40/create"
payload = json.dumps({
"Receptor": {
"UID": "63ebd090d6015"
},
"TipoDocumento": "carta_porte",
"RegimenFiscal": "606",
"UsoCFDI": "S01",
"Redondeo": "2",
"Conceptos": [
{
"ClaveProdServ": "78101800",
"Cantidad": "1.00",
"ClaveUnidad": "E48",
"Unidad": "Unidad de servicio",
"Descripcion": "SERVICIO DE FLETE NACAJUCA 1 A 5 REPARTOS NO. DE TRANSPORTE 289822 NO. DE RUTA 310753 SALIO DE CEDIS IXTACOMITAN UNIDAD 3.5 TONELADAS",
"ValorUnitario": "2200.00",
"Importe": "2200",
"Impuestos": {
"Traslados": [
{
"Base": "2200",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.16",
"Importe": "352"
}
],
"Retenidos": [
{
"Base": "2200",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.04",
"Importe": "88"
}
]
}
}
],
"FormaPago": "99",
"MetodoPago": "PPD",
"Moneda": "MXN",
"Serie": "50450",
"CartaPorte": {
"Version": "3.1",
"IdCCP": "CCCDA373-FB1A-44AE-83A2-448B0865BDA3",
"TranspInternac": "No",
"TotalDistRec": "300",
"Ubicaciones": {
"Ubicacion": [
{
"IDUbicacion": "OR123456",
"FechaHoraSalidaLlegada": "2023-10-05T07:00:00",
"RFCRemitenteDestinatario": "TPM9809038X0",
"NombreRemitenteDestinatario": "THYSSENKRUPP PRESTA DE MEXICO, S.A. DE C.V. PM1",
"TipoUbicacion": "Origen",
"Domicilio": {
"Calle": "Calle Circuito Esteban de Antuñano",
"Estado": "PUE",
"Pais": "MEX",
"CodigoPostal": "74160",
"Colonia": "1500",
"Municipio": "074"
}
},
{
"IDUbicacion": "DE654321",
"DistanciaRecorrida": "300",
"FechaHoraSalidaLlegada": "2023-10-05T13:50:00",
"RFCRemitenteDestinatario": "STE071214BE7",
"NombreRemitenteDestinatario": "Nexteer PLANTA 69",
"TipoUbicacion": "Destino",
"Domicilio": {
"Calle": "",
"Estado": "QUE",
"Pais": "MEX",
"CodigoPostal": "76246",
"Colonia": "0001",
"Municipio": "011"
}
}
]
},
"Mercancias": {
"Mercancia": [
{
"PesoEnKg": "723",
"Cantidad": "4224",
"BienesTransp": "25174200",
"ClaveUnidad": "H87",
"Descripcion": "Sistema de dirección",
"FraccionArancelaria": "",
"UUIDComercioExt": "",
"CantidadTransporta": [
{
"Cantidad": "4224",
"IDOrigen": "OR123456",
"IDDestino": "DE654321"
}
]
}
],
"Autotransporte": {
"NumPermisoSCT": "9639934",
"PermSCT": "TPAF01",
"IdentificacionVehicular": {
"AnioModeloVM": "2023",
"PesoBrutoVehicular": "200",
"ConfigVehicular": "VL",
"PlacaVM": "99AX7H"
},
"Seguros": {
"AseguraRespCivil": "BANORTE",
"PolizaRespCivil": "4111867"
}
},
"NumTotalMercancias": "1",
"PesoBrutoTotal": "723",
"UnidadPeso": "KGM"
},
"FiguraTransporte": {
"TiposFigura": [
{
"Domicilio": {
"Calle": "",
"NumeroInterior": "",
"Colonia": "",
"Localidad": "03",
"Municipio": "009",
"Estado": "COL",
"Pais": "MEX",
"CodigoPostal": "28934"
},
"TipoFigura": "01",
"RFCFigura": "CALJ741208LN5",
"NumLicencia": "PUE0011259",
"NombreFigura": "JUAN RENE CARRASCO LIZANA"
}
]
}
}
})
headers = {
'Content-Type': 'application/json',
'F-PLUGIN': '9d4095c8f7ed5785cb14c0e3b033eeb8252416ed',
'F-Api-Key': 'Tu API key',
'F-Secret-Key': 'Tu Secret key'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
require "uri"
require "json"
require "net/http"
url = URI("{ HOST }/v4/cfdi40/create")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request["F-PLUGIN"] = "9d4095c8f7ed5785cb14c0e3b033eeb8252416ed"
request["F-Api-Key"] = "Tu API key"
request["F-Secret-Key"] = "Tu Secret key"
request.body = JSON.dump({
"Receptor": {
"UID": "63ebd090d6015"
},
"TipoDocumento": "carta_porte",
"RegimenFiscal": "606",
"UsoCFDI": "S01",
"Redondeo": "2",
"Conceptos": [
{
"ClaveProdServ": "78101800",
"Cantidad": "1.00",
"ClaveUnidad": "E48",
"Unidad": "Unidad de servicio",
"Descripcion": "SERVICIO DE FLETE NACAJUCA 1 A 5 REPARTOS NO. DE TRANSPORTE 289822 NO. DE RUTA 310753 SALIO DE CEDIS IXTACOMITAN UNIDAD 3.5 TONELADAS",
"ValorUnitario": "2200.00",
"Importe": "2200",
"Impuestos": {
"Traslados": [
{
"Base": "2200",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.16",
"Importe": "352"
}
],
"Retenidos": [
{
"Base": "2200",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.04",
"Importe": "88"
}
]
}
}
],
"FormaPago": "99",
"MetodoPago": "PPD",
"Moneda": "MXN",
"Serie": "50450",
"CartaPorte": {
"Version": "3.1",
"IdCCP": "CCCDA373-FB1A-44AE-83A2-448B0865BDA3",
"TranspInternac": "No",
"TotalDistRec": "300",
"Ubicaciones": {
"Ubicacion": [
{
"IDUbicacion": "OR123456",
"FechaHoraSalidaLlegada": "2023-10-05T07:00:00",
"RFCRemitenteDestinatario": "TPM9809038X0",
"NombreRemitenteDestinatario": "THYSSENKRUPP PRESTA DE MEXICO, S.A. DE C.V. PM1",
"TipoUbicacion": "Origen",
"Domicilio": {
"Calle": "Calle Circuito Esteban de Antuñano",
"Estado": "PUE",
"Pais": "MEX",
"CodigoPostal": "74160",
"Colonia": "1500",
"Municipio": "074"
}
},
{
"IDUbicacion": "DE654321",
"DistanciaRecorrida": "300",
"FechaHoraSalidaLlegada": "2023-10-05T13:50:00",
"RFCRemitenteDestinatario": "STE071214BE7",
"NombreRemitenteDestinatario": "Nexteer PLANTA 69",
"TipoUbicacion": "Destino",
"Domicilio": {
"Calle": "",
"Estado": "QUE",
"Pais": "MEX",
"CodigoPostal": "76246",
"Colonia": "0001",
"Municipio": "011"
}
}
]
},
"Mercancias": {
"Mercancia": [
{
"PesoEnKg": "723",
"Cantidad": "4224",
"BienesTransp": "25174200",
"ClaveUnidad": "H87",
"Descripcion": "Sistema de dirección",
"FraccionArancelaria": "",
"UUIDComercioExt": "",
"CantidadTransporta": [
{
"Cantidad": "4224",
"IDOrigen": "OR123456",
"IDDestino": "DE654321"
}
]
}
],
"Autotransporte": {
"NumPermisoSCT": "9639934",
"PermSCT": "TPAF01",
"IdentificacionVehicular": {
"AnioModeloVM": "2023",
"PesoBrutoVehicular": "200",
"ConfigVehicular": "VL",
"PlacaVM": "99AX7H"
},
"Seguros": {
"AseguraRespCivil": "BANORTE",
"PolizaRespCivil": "4111867"
}
},
"NumTotalMercancias": "1",
"PesoBrutoTotal": "723",
"UnidadPeso": "KGM"
},
"FiguraTransporte": {
"TiposFigura": [
{
"Domicilio": {
"Calle": "",
"NumeroInterior": "",
"Colonia": "",
"Localidad": "03",
"Municipio": "009",
"Estado": "COL",
"Pais": "MEX",
"CodigoPostal": "28934"
},
"TipoFigura": "01",
"RFCFigura": "CALJ741208LN5",
"NumLicencia": "PUE0011259",
"NombreFigura": "JUAN RENE CARRASCO LIZANA"
}
]
}
}
})
response = https.request(request)
puts response.read_body
CFDI con transporte Internacional
Tip en este ejemplo se muestra como utilizar los nuevos campos de la version 3.1 de carta porte para transporte internacional, estos campos se utilizan de la misma forma para cfdi de traslado.
Para crear un CFDI de traslado debemos enviar el parametro como aparece a continuación:
"TipoDocumento": "carta_porte"
Construcción de la URL
Host: https://facturaonline.com.mx/api (producción) / https://sandbox.facturaonline.com.mx/api (sandbox)
Endpoint: /v4/cfdi40/create
Ejemplo: https://facturaonline.com.mx/api/v4/cfdi40/create
Tip
Para probar el ejemplo de código, necesitas cambiar "Tu API key" por la clave de API de tu cuenta, y "Tu Secret key" por la clave secreta correspondiente.
Ejemplo de CFDI de ingreso con transporte internacional
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => '{ HOST }/v4/cfdi40/create',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"Receptor": {
"UID": "63ebd090d6015"
},
"TipoDocumento": "carta_porte_ingreso",
"RegimenFiscal": "606",
"UsoCFDI": "S01",
"Redondeo": "2",
"Conceptos": [
{
"ClaveProdServ": "78101800",
"Cantidad": "1.00",
"ClaveUnidad": "E48",
"Unidad": "Unidad de servicio",
"Descripcion": "SERVICIO DE FLETE NACAJUCA 1 A 5 REPARTOS NO. DE TRANSPORTE 289822 NO. DE RUTA 310753 SALIO DE CEDIS IXTACOMITAN UNIDAD 3.5 TONELADAS",
"ValorUnitario": "2200.00",
"Importe": "2200",
"Impuestos": {
"Traslados": [
{
"Base": "2200",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.16",
"Importe": "352"
}
],
"Retenidos": [
{
"Base": "2200",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.04",
"Importe": "88"
}
]
}
}
],
"FormaPago": "99",
"MetodoPago": "PPD",
"Moneda": "MXN",
"Serie": "50450",
"CartaPorte": {
"Version": "3.1",
"IdCCP": "CCCDA373-FB1A-44AE-83A2-448B0865BDA3",
"TranspInternac": "Sí",
"EntradaSalidaMerc": "Salida",
"TotalDistRec": "300",
"RegimenesAduaneros":{
"RegimenAduaneroCCP": [
{"RegimenAduanero": "EXD"}
]
},
"Ubicaciones": {
"Ubicacion": [
{
"IDUbicacion": "OR123456",
"FechaHoraSalidaLlegada": "2023-10-05T07:00:00",
"RFCRemitenteDestinatario": "TPM9809038X0",
"NombreRemitenteDestinatario": "THYSSENKRUPP PRESTA DE MEXICO, S.A. DE C.V. PM1",
"TipoUbicacion": "Origen",
"Domicilio": {
"Calle": "Calle Circuito Esteban de Antuñano",
"Estado": "PUE",
"Pais": "MEX",
"CodigoPostal": "74160",
"Colonia": "1500",
"Municipio": "074"
}
},
{
"IDUbicacion": "DE654321",
"DistanciaRecorrida": "300",
"FechaHoraSalidaLlegada": "2023-10-05T13:50:00",
"RFCRemitenteDestinatario": "STE071214BE7",
"NombreRemitenteDestinatario": "Nexteer PLANTA 69",
"TipoUbicacion": "Destino",
"Domicilio": {
"Calle": "",
"Estado": "QUE",
"Pais": "MEX",
"CodigoPostal": "76246",
"Colonia": "0001",
"Municipio": "011"
}
}
]
},
"Mercancias": {
"Mercancia": [
{
"PesoEnKg": "723",
"Cantidad": "4224",
"BienesTransp": "25174200",
"ClaveUnidad": "H87",
"Descripcion": "Sistema de dirección",
"FraccionArancelaria": "",
"UUIDComercioExt": "",
"CantidadTransporta": [{
"Cantidad": "4224",
"IDOrigen": "OR123456",
"IDDestino": "DE654321"
}]
}
],
"Autotransporte": {
"NumPermisoSCT": "9639934",
"PermSCT": "TPAF01",
"IdentificacionVehicular": {
"AnioModeloVM": "2023",
"PesoBrutoVehicular": "200",
"ConfigVehicular": "VL",
"PlacaVM": "99AX7H"
},
"Seguros": {
"AseguraRespCivil": "BANORTE",
"PolizaRespCivil": "4111867"
}
},
"NumTotalMercancias": "1",
"PesoBrutoTotal": "723",
"UnidadPeso": "KGM"
},
"FiguraTransporte": {
"TiposFigura": [
{
"Domicilio": {
"Calle": "",
"NumeroInterior": "",
"Colonia": "",
"Localidad": "03",
"Municipio": "009",
"Estado": "COL",
"Pais": "MEX",
"CodigoPostal": "28934"
},
"TipoFigura": "01",
"RFCFigura": "CALJ741208LN5",
"NumLicencia": "PUE0011259",
"NombreFigura": "JUAN RENE CARRASCO LIZANA"
}
]
}
}
} ',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json',
'F-PLUGIN: 9d4095c8f7ed5785cb14c0e3b033eeb8252416ed',
'F-Api-Key: Tu API key',
'F-Secret-Key: Tu Secret key'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
var request = require('request');
var options = {
'method': 'POST',
'url': '{ HOST }/v4/cfdi40/create',
'headers': {
'Content-Type': 'application/json',
'F-PLUGIN': '9d4095c8f7ed5785cb14c0e3b033eeb8252416ed',
'F-Api-Key': 'Tu API key',
'F-Secret-Key': 'Tu Secret key'
},
body: JSON.stringify({
"Receptor": {
"UID": "63ebd090d6015"
},
"TipoDocumento": "carta_porte_ingreso",
"RegimenFiscal": "606",
"UsoCFDI": "S01",
"Redondeo": "2",
"Conceptos": [
{
"ClaveProdServ": "78101800",
"Cantidad": "1.00",
"ClaveUnidad": "E48",
"Unidad": "Unidad de servicio",
"Descripcion": "SERVICIO DE FLETE NACAJUCA 1 A 5 REPARTOS NO. DE TRANSPORTE 289822 NO. DE RUTA 310753 SALIO DE CEDIS IXTACOMITAN UNIDAD 3.5 TONELADAS",
"ValorUnitario": "2200.00",
"Importe": "2200",
"Impuestos": {
"Traslados": [
{
"Base": "2200",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.16",
"Importe": "352"
}
],
"Retenidos": [
{
"Base": "2200",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.04",
"Importe": "88"
}
]
}
}
],
"FormaPago": "99",
"MetodoPago": "PPD",
"Moneda": "MXN",
"Serie": "50450",
"CartaPorte": {
"Version": "3.1",
"IdCCP": "CCCDA373-FB1A-44AE-83A2-448B0865BDA3",
"TranspInternac": "Sí",
"EntradaSalidaMerc": "Salida",
"TotalDistRec": "300",
"RegimenesAduaneros":{
"RegimenAduaneroCCP": [
{"RegimenAduanero": "EXD"}
]
},
"Ubicaciones": {
"Ubicacion": [
{
"IDUbicacion": "OR123456",
"FechaHoraSalidaLlegada": "2023-10-05T07:00:00",
"RFCRemitenteDestinatario": "TPM9809038X0",
"NombreRemitenteDestinatario": "THYSSENKRUPP PRESTA DE MEXICO, S.A. DE C.V. PM1",
"TipoUbicacion": "Origen",
"Domicilio": {
"Calle": "Calle Circuito Esteban de Antuñano",
"Estado": "PUE",
"Pais": "MEX",
"CodigoPostal": "74160",
"Colonia": "1500",
"Municipio": "074"
}
},
{
"IDUbicacion": "DE654321",
"DistanciaRecorrida": "300",
"FechaHoraSalidaLlegada": "2023-10-05T13:50:00",
"RFCRemitenteDestinatario": "STE071214BE7",
"NombreRemitenteDestinatario": "Nexteer PLANTA 69",
"TipoUbicacion": "Destino",
"Domicilio": {
"Calle": "",
"Estado": "TX",
"Pais": "USA",
"CodigoPostal": "01837",
"Colonia": "0001",
"Municipio": "011"
}
}
]
},
"Mercancias": {
"Mercancia": [
{
"PesoEnKg": "723",
"Cantidad": "4224",
"BienesTransp": "25174200",
"ClaveUnidad": "H87",
"Descripcion": "Sistema de dirección",
"FraccionArancelaria": "",
"UUIDComercioExt": "",
"CantidadTransporta": [
{
"Cantidad": "4224",
"IDOrigen": "OR123456",
"IDDestino": "DE654321"
}
]
}
],
"Autotransporte": {
"NumPermisoSCT": "9639934",
"PermSCT": "TPAF01",
"IdentificacionVehicular": {
"AnioModeloVM": "2023",
"PesoBrutoVehicular": "200",
"ConfigVehicular": "VL",
"PlacaVM": "99AX7H"
},
"Seguros": {
"AseguraRespCivil": "BANORTE",
"PolizaRespCivil": "4111867"
}
},
"NumTotalMercancias": "1",
"PesoBrutoTotal": "723",
"UnidadPeso": "KGM"
},
"FiguraTransporte": {
"TiposFigura": [
{
"Domicilio": {
"Calle": "",
"NumeroInterior": "",
"Colonia": "",
"Localidad": "03",
"Municipio": "009",
"Estado": "COL",
"Pais": "MEX",
"CodigoPostal": "28934"
},
"TipoFigura": "01",
"RFCFigura": "CALJ741208LN5",
"NumLicencia": "PUE0011259",
"NombreFigura": "JUAN RENE CARRASCO LIZANA"
}
]
}
}
})
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
import requests
import json
url = "{ HOST }/v4/cfdi40/create"
payload = json.dumps({
"Receptor": {
"UID": "63ebd090d6015"
},
"TipoDocumento": "carta_porte_ingreso",
"RegimenFiscal": "606",
"UsoCFDI": "S01",
"Redondeo": "2",
"Conceptos": [
{
"ClaveProdServ": "78101800",
"Cantidad": "1.00",
"ClaveUnidad": "E48",
"Unidad": "Unidad de servicio",
"Descripcion": "SERVICIO DE FLETE NACAJUCA 1 A 5 REPARTOS NO. DE TRANSPORTE 289822 NO. DE RUTA 310753 SALIO DE CEDIS IXTACOMITAN UNIDAD 3.5 TONELADAS",
"ValorUnitario": "2200.00",
"Importe": "2200",
"Impuestos": {
"Traslados": [
{
"Base": "2200",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.16",
"Importe": "352"
}
],
"Retenidos": [
{
"Base": "2200",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.04",
"Importe": "88"
}
]
}
}
],
"FormaPago": "99",
"MetodoPago": "PPD",
"Moneda": "MXN",
"Serie": "50450",
"CartaPorte": {
"Version": "3.1",
"IdCCP": "CCCDA373-FB1A-44AE-83A2-448B0865BDA3",
"TranspInternac": "Sí",
"EntradaSalidaMerc": "Salida",
"TotalDistRec": "300",
"RegimenesAduaneros":{
"RegimenAduaneroCCP": [
{"RegimenAduanero": "EXD"}
]
},
"Ubicaciones": {
"Ubicacion": [
{
"IDUbicacion": "OR123456",
"FechaHoraSalidaLlegada": "2023-10-05T07:00:00",
"RFCRemitenteDestinatario": "TPM9809038X0",
"NombreRemitenteDestinatario": "THYSSENKRUPP PRESTA DE MEXICO, S.A. DE C.V. PM1",
"TipoUbicacion": "Origen",
"Domicilio": {
"Calle": "Calle Circuito Esteban de Antuñano",
"Estado": "PUE",
"Pais": "MEX",
"CodigoPostal": "74160",
"Colonia": "1500",
"Municipio": "074"
}
},
{
"IDUbicacion": "DE654321",
"DistanciaRecorrida": "300",
"FechaHoraSalidaLlegada": "2023-10-05T13:50:00",
"RFCRemitenteDestinatario": "STE071214BE7",
"NombreRemitenteDestinatario": "Nexteer PLANTA 69",
"TipoUbicacion": "Destino",
"Domicilio": {
"Calle": "",
"Estado": "QUE",
"Pais": "MEX",
"CodigoPostal": "76246",
"Colonia": "0001",
"Municipio": "011"
}
}
]
},
"Mercancias": {
"Mercancia": [
{
"PesoEnKg": "723",
"Cantidad": "4224",
"BienesTransp": "25174200",
"ClaveUnidad": "H87",
"Descripcion": "Sistema de dirección",
"FraccionArancelaria": "",
"UUIDComercioExt": "",
"CantidadTransporta": [
{
"Cantidad": "4224",
"IDOrigen": "OR123456",
"IDDestino": "DE654321"
}
]
}
],
"Autotransporte": {
"NumPermisoSCT": "9639934",
"PermSCT": "TPAF01",
"IdentificacionVehicular": {
"AnioModeloVM": "2023",
"PesoBrutoVehicular": "200",
"ConfigVehicular": "VL",
"PlacaVM": "99AX7H"
},
"Seguros": {
"AseguraRespCivil": "BANORTE",
"PolizaRespCivil": "4111867"
}
},
"NumTotalMercancias": "1",
"PesoBrutoTotal": "723",
"UnidadPeso": "KGM"
},
"FiguraTransporte": {
"TiposFigura": [
{
"Domicilio": {
"Calle": "",
"NumeroInterior": "",
"Colonia": "",
"Localidad": "03",
"Municipio": "009",
"Estado": "COL",
"Pais": "MEX",
"CodigoPostal": "28934"
},
"TipoFigura": "01",
"RFCFigura": "CALJ741208LN5",
"NumLicencia": "PUE0011259",
"NombreFigura": "JUAN RENE CARRASCO LIZANA"
}
]
}
}
})
headers = {
'Content-Type': 'application/json',
'F-PLUGIN': '9d4095c8f7ed5785cb14c0e3b033eeb8252416ed',
'F-Api-Key': 'Tu API key',
'F-Secret-Key': 'Tu Secret key'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
require "uri"
require "json"
require "net/http"
url = URI("{ HOST }/v4/cfdi40/create")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request["F-PLUGIN"] = "9d4095c8f7ed5785cb14c0e3b033eeb8252416ed"
request["F-Api-Key"] = "Tu API key"
request["F-Secret-Key"] = "Tu Secret key"
request.body = JSON.dump({
"Receptor": {
"UID": "63ebd090d6015"
},
"TipoDocumento": "carta_porte_ingreso",
"RegimenFiscal": "606",
"UsoCFDI": "S01",
"Redondeo": "2",
"Conceptos": [
{
"ClaveProdServ": "78101800",
"Cantidad": "1.00",
"ClaveUnidad": "E48",
"Unidad": "Unidad de servicio",
"Descripcion": "SERVICIO DE FLETE NACAJUCA 1 A 5 REPARTOS NO. DE TRANSPORTE 289822 NO. DE RUTA 310753 SALIO DE CEDIS IXTACOMITAN UNIDAD 3.5 TONELADAS",
"ValorUnitario": "2200.00",
"Importe": "2200",
"Impuestos": {
"Traslados": [
{
"Base": "2200",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.16",
"Importe": "352"
}
],
"Retenidos": [
{
"Base": "2200",
"Impuesto": "002",
"TipoFactor": "Tasa",
"TasaOCuota": "0.04",
"Importe": "88"
}
]
}
}
],
"FormaPago": "99",
"MetodoPago": "PPD",
"Moneda": "MXN",
"Serie": "50450",
"CartaPorte": {
"Version": "3.1",
"IdCCP": "CCCDA373-FB1A-44AE-83A2-448B0865BDA3",
"TranspInternac": "Sí",
"EntradaSalidaMerc": "Salida",
"TotalDistRec": "300",
"RegimenesAduaneros":{
"RegimenAduaneroCCP": [
{"RegimenAduanero": "EXD"}
]
},
"Ubicaciones": {
"Ubicacion": [
{
"IDUbicacion": "OR123456",
"FechaHoraSalidaLlegada": "2023-10-05T07:00:00",
"RFCRemitenteDestinatario": "TPM9809038X0",
"NombreRemitenteDestinatario": "THYSSENKRUPP PRESTA DE MEXICO, S.A. DE C.V. PM1",
"TipoUbicacion": "Origen",
"Domicilio": {
"Calle": "Calle Circuito Esteban de Antuñano",
"Estado": "PUE",
"Pais": "MEX",
"CodigoPostal": "74160",
"Colonia": "1500",
"Municipio": "074"
}
},
{
"IDUbicacion": "DE654321",
"DistanciaRecorrida": "300",
"FechaHoraSalidaLlegada": "2023-10-05T13:50:00",
"RFCRemitenteDestinatario": "STE071214BE7",
"NombreRemitenteDestinatario": "Nexteer PLANTA 69",
"TipoUbicacion": "Destino",
"Domicilio": {
"Calle": "",
"Estado": "QUE",
"Pais": "MEX",
"CodigoPostal": "76246",
"Colonia": "0001",
"Municipio": "011"
}
}
]
},
"Mercancias": {
"Mercancia": [
{
"PesoEnKg": "723",
"Cantidad": "4224",
"BienesTransp": "25174200",
"ClaveUnidad": "H87",
"Descripcion": "Sistema de dirección",
"FraccionArancelaria": "",
"UUIDComercioExt": "",
"CantidadTransporta": [
{
"Cantidad": "4224",
"IDOrigen": "OR123456",
"IDDestino": "DE654321"
}
]
}
],
"Autotransporte": {
"NumPermisoSCT": "9639934",
"PermSCT": "TPAF01",
"IdentificacionVehicular": {
"AnioModeloVM": "2023",
"PesoBrutoVehicular": "200",
"ConfigVehicular": "VL",
"PlacaVM": "99AX7H"
},
"Seguros": {
"AseguraRespCivil": "BANORTE",
"PolizaRespCivil": "4111867"
}
},
"NumTotalMercancias": "1",
"PesoBrutoTotal": "723",
"UnidadPeso": "KGM"
},
"FiguraTransporte": {
"TiposFigura": [
{
"Domicilio": {
"Calle": "",
"NumeroInterior": "",
"Colonia": "",
"Localidad": "03",
"Municipio": "009",
"Estado": "COL",
"Pais": "MEX",
"CodigoPostal": "28934"
},
"TipoFigura": "01",
"RFCFigura": "CALJ741208LN5",
"NumLicencia": "PUE0011259",
"NombreFigura": "JUAN RENE CARRASCO LIZANA"
}
]
}
}
})
response = https.request(request)
puts response.read_body
Ejemplo de respuesta erronea.
{
"response": "error",
"message": "El IdCCP ya existe"
}
Aviso
El mensaje de error puede variar dependiendo el nodo en el que haya información incorrecta. Te sugerimos leer cuidadosamente el mensaje del error ya que en el mismo se indica donde es necesario corregir la información.