cartaporte31

cartaporte31 http://www.sat.gob.mx/CartaPorte31

class satcfdi.create.cfd.cartaporte31.Domicilio(estado: str, pais: str, codigo_postal: str, calle: str = None, numero_exterior: str = None, numero_interior: str = None, colonia: str = None, localidad: str = None, referencia: str = None, municipio: str = None)[source]

Bases: ScalarMap

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.

Parameters:

estado – Atributo requerido para registrar el estado, entidad, región, comunidad, o dato análogo en donde se encuentra ubicado el domicilio del(los) tipo(s) de figura transporte.
pais – Atributo requerido que sirve para registrar la clave del país en donde se encuentra ubicado el domicilio del(los) tipo(s) de figura transporte, conforme al catálogo c_Pais del CFDI publicado en el portal del SAT en Internet de acuerdo a la especificación ISO 3166-1.
codigo_postal – Atributo requerido para registrar el código postal en donde se encuentra ubicado el domicilio del(los) tipo(s) de figura transporte.
calle – Atributo opcional que sirve para registrar la calle en la que está ubicado el domicilio del(los) tipo(s) de figura transporte.
numero_exterior – Atributo opcional que sirve para registrar el número exterior en donde se ubica el domicilio del(los) tipo(s) de figura transporte.
numero_interior – Atributo opcional que sirve para registrar el número interior, en caso de existir, en donde se ubica el domicilio del(los) tipo(s) de figura transporte.
colonia – Atributo opcional que sirve para expresar la clave de la colonia o dato análogo en donde se ubica el domicilio del(los) tipo(s) de figura transporte.
localidad – Atributo opcional para registrar la clave de la ciudad, población, distrito o dato análogo de donde se encuentra ubicado el domicilio del(los) tipo(s) de figura transporte.
referencia – Atributo opcional para registrar una referencia geográfica adicional que permita una fácil o precisa ubicación del domicilio del(los) tipo(s) de figura transporte; por ejemplo, las coordenadas del GPS.
municipio – Atributo opcional para registrar la clave del municipio, delegación o alcaldía, condado o dato análogo en donde se encuentra ubicado el domicilio del(los) tipo(s) de figura transporte.

class satcfdi.create.cfd.cartaporte31.TiposFigura(tipo_figura: str, nombre_figura: str, rfc_figura: str = None, num_licencia: str = None, num_reg_id_trib_figura: str = None, residencia_fiscal_figura: str = None, partes_transporte: str | Sequence[str] = None, domicilio: Domicilio | dict = None)[source]

Bases: ScalarMap

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.

Parameters:

tipo_figura – Atributo requerido para registrar la clave de la figura de transporte que interviene en el traslado de los bienes y/o mercancías.
nombre_figura – Atributo requerido para registrar el nombre de la figura de transporte que interviene en el traslado de los bienes y/o mercancías.
rfc_figura – Atributo condicional para registrar el RFC de la figura de transporte que interviene en el traslado de los bienes y/o mercancías.
num_licencia – 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.
num_reg_id_trib_figura – 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.
residencia_fiscal_figura – 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.
partes_transporte – 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 – 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.

class satcfdi.create.cfd.cartaporte31.DerechosDePaso(tipo_derecho_de_paso: str, kilometraje_pagado: Decimal | int)[source]

Bases: ScalarMap

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.

Parameters:

tipo_derecho_de_paso – 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.
kilometraje_pagado – 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.

class satcfdi.create.cfd.cartaporte31.Contenedor(tipo_contenedor: str, peso_contenedor_vacio: Decimal | int, peso_neto_mercancia: Decimal | int)[source]

Bases: ScalarMap

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.

Parameters:

tipo_contenedor – 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.
peso_contenedor_vacio – Atributo requerido para registrar en kilogramos, el peso del contenedor vacío en el que se trasladan los bienes y/o mercancías.
peso_neto_mercancia – Atributo requerido para registrar en kilogramos el peso neto de los bienes y/o mercancías que son trasladados en el contenedor.

class satcfdi.create.cfd.cartaporte31.Carro(tipo_carro: str, matricula_carro: str, guia_carro: str, toneladas_netas_carro: Decimal | int, contenedor: Contenedor | dict | Sequence[Contenedor | dict] = None)[source]

Bases: ScalarMap

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.

Parameters:

tipo_carro – 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.
matricula_carro – 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.
guia_carro – 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.
toneladas_netas_carro – 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 – 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.

class satcfdi.create.cfd.cartaporte31.TransporteFerroviario(tipo_de_servicio: str, tipo_de_trafico: str, carro: Carro | dict | Sequence[Carro | dict], nombre_aseg: str = None, num_poliza_seguro: str = None, derechos_de_paso: DerechosDePaso | dict | Sequence[DerechosDePaso | dict] = None)[source]

Bases: ScalarMap

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.

Parameters:

tipo_de_servicio – 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.
tipo_de_trafico – 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.
carro – 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.
nombre_aseg – 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.
num_poliza_seguro – 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.
derechos_de_paso – 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.

class satcfdi.create.cfd.cartaporte31.TransporteAereo(perm_sct: str, num_permiso_sct: str, numero_guia: str, codigo_transportista: str, matricula_aeronave: str = None, nombre_aseg: str = None, num_poliza_seguro: str = None, lugar_contrato: str = None, rfc_embarcador: str = None, num_reg_id_trib_embarc: str = None, residencia_fiscal_embarc: str = None, nombre_embarcador: str = None)[source]

Bases: ScalarMap

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.

Parameters:

perm_sct – 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.
num_permiso_sct – 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.
numero_guia – Atributo requerido para registrar el número de guía aérea con el que se trasladan los bienes y/o mercancías.
codigo_transportista – 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.
matricula_aeronave – 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 “-“.
nombre_aseg – 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.
num_poliza_seguro – 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.
lugar_contrato – 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.
rfc_embarcador – Atributo opcional para registrar el RFC del embarcador de los bienes y/o mercancías que se trasladan.
num_reg_id_trib_embarc – 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.
residencia_fiscal_embarc – Atributo condicional para registrar la clave del país de residencia para efectos fiscales del embarcador de los bienes y/o mercancías.
nombre_embarcador – Atributo opcional para registrar el nombre del embarcador de los bienes y/o mercancías que se trasladan, ya sea nacional o extranjero.

class satcfdi.create.cfd.cartaporte31.RemolqueCCP(sub_tipo_rem_ccp: str, placa_ccp: str)[source]

Bases: ScalarMap

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.

Parameters:

sub_tipo_rem_ccp – 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.
placa_ccp – Atributo requerido para registrar los caracteres alfanuméricos, sin guiones ni espacios de la placa del remolque o semirremolque registrado en el CFDI con complemento Carta Porte, únicamente aplica para traslado mediante ferri.

class satcfdi.create.cfd.cartaporte31.TransporteMaritimo(tipo_embarcacion: str, matricula: str, numero_omi: str, nacionalidad_embarc: str, unidades_de_arq_bruto: Decimal | int, tipo_carga: str, nombre_agente_naviero: str, num_autorizacion_naviero: str, perm_sct: str = None, num_permiso_sct: str = None, nombre_aseg: str = None, num_poliza_seguro: str = None, anio_embarcacion: int = None, nombre_embarc: str = None, eslora: Decimal | int = None, manga: Decimal | int = None, calado: Decimal | int = None, puntal: Decimal | int = None, linea_naviera: str = None, num_viaje: str = None, num_conoc_embarc: str = None, permiso_temp_navegacion: str = None, contenedor: Contenedor | dict | Sequence[Contenedor | dict] = None)[source]

Bases: ScalarMap

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.

Parameters:

tipo_embarcacion – 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 – 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.
numero_omi – 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.
nacionalidad_embarc – 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.
unidades_de_arq_bruto – 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.
tipo_carga – 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.
nombre_agente_naviero – 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.
num_autorizacion_naviero – Atributo requerido para expresar el número de la autorización como agente naviero consignatario emitida por la autoridad correspondiente.
perm_sct – 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.
num_permiso_sct – 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.
nombre_aseg – 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.
num_poliza_seguro – 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.
anio_embarcacion – Atributo opcional para registrar el año de la embarcación en la que se transportan los bienes y/o mercancías.
nombre_embarc – Atributo opcional para registrar el nombre de la embarcación en la que se realiza el traslado de los bienes y/o mercancías.
eslora – 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 – 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 – 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 – 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.
linea_naviera – 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.
num_viaje – 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.
num_conoc_embarc – 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.
permiso_temp_navegacion – 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 – Nodo opcional para registrar los datos del contenedor en el que se transportan los bienes y/o mercancías.

class satcfdi.create.cfd.cartaporte31.Remolque(sub_tipo_rem: str, placa: str)[source]

Bases: ScalarMap

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.

Parameters:

sub_tipo_rem – Atributo requerido para expresar la clave del subtipo de remolque o semirremolques que se emplean con el autotransporte para el traslado de los bienes y/o mercancías.
placa – 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.

class satcfdi.create.cfd.cartaporte31.Seguros(asegura_resp_civil: str, poliza_resp_civil: str, asegura_med_ambiente: str = None, poliza_med_ambiente: str = None, asegura_carga: str = None, poliza_carga: str = None, prima_seguro: Decimal | int = None)[source]

Bases: ScalarMap

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.

Parameters:

asegura_resp_civil – 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.
poliza_resp_civil – 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.
asegura_med_ambiente – 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.
poliza_med_ambiente – Atributo condicional para registrar el número de póliza asignado 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).
asegura_carga – 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.
poliza_carga – 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.
prima_seguro – 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).

class satcfdi.create.cfd.cartaporte31.IdentificacionVehicular(config_vehicular: str, peso_bruto_vehicular: Decimal | int, placa_vm: str, anio_modelo_vm: int)[source]

Bases: ScalarMap

Nodo requerido para registrar los datos de identificación del autotransporte en el que se trasladan los bienes y/o mercancías.

Parameters:

config_vehicular – Atributo requerido para expresar la clave de nomenclatura del autotransporte que es utilizado para transportar los bienes y/o mercancías.
peso_bruto_vehicular – Atributo requerido para indicar en toneladas el peso bruto vehicular permitido del autotransporte de acuerdo a la NOM-SCT-012-2017 que es utilizado para realizar el traslado de los bienes y/o mercancías.
placa_vm – 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.
anio_modelo_vm – Atributo requerido para registrar el año del autotransporte que es utilizado para transportar los bienes y/o mercancías.

Bases: ScalarMap

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.

Parameters:

perm_sct – 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.
num_permiso_sct – 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.
identificacion_vehicular – Nodo requerido para registrar los datos de identificación del autotransporte en el que se trasladan los bienes y/o mercancías.
seguros – 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 – 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.

class satcfdi.create.cfd.cartaporte31.DetalleMercancia(unidad_peso_merc: str, peso_bruto: Decimal | int, peso_neto: Decimal | int, peso_tara: Decimal | int, num_piezas: int = None)[source]

Bases: ScalarMap

Nodo condicional para registrar especificaciones de los bienes y/o mercancías que se trasladan a través de los distintos medios de transporte.

Parameters:

unidad_peso_merc – 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.
peso_bruto – 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.
peso_neto – Atributo requerido para registrar el peso neto total de los bienes y/o mercancías que se trasladan en los distintos medios de transporte.
peso_tara – 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.
num_piezas – 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.

class satcfdi.create.cfd.cartaporte31.CantidadTransporta(cantidad: Decimal | int, id_origen: str, id_destino: str, cves_transporte: str = None)[source]

Bases: ScalarMap

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.

Parameters:

cantidad – Atributo requerido para expresar el número de bienes y/o mercancías que se trasladan en los distintos medios de transporte.
id_origen – 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”.
id_destino – 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”.
cves_transporte – 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.

class satcfdi.create.cfd.cartaporte31.GuiasIdentificacion(numero_guia_identificacion: str, descrip_guia_identificacion: str, peso_guia_identificacion: Decimal | int)[source]

Bases: ScalarMap

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.

Parameters:

numero_guia_identificacion – 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.
descrip_guia_identificacion – 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.
peso_guia_identificacion – 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.

class satcfdi.create.cfd.cartaporte31.DocumentacionAduanera(tipo_documento: str, num_pedimento: str = None, ident_doc_aduanero: str = None, rfc_impo: str = None)[source]

Bases: ScalarMap

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.

Parameters:

tipo_documento – 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.
num_pedimento – 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.
ident_doc_aduanero – 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.
rfc_impo – Atributo 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).

class satcfdi.create.cfd.cartaporte31.Mercancia(bienes_transp: str, descripcion: str, cantidad: Decimal | int, clave_unidad: str, peso_en_kg: Decimal | int, clave_stcc: str = None, unidad: str = None, dimensiones: str = None, material_peligroso: str = None, cve_material_peligroso: str = None, embalaje: str = None, descrip_embalaje: str = None, sector_cofepris: str = None, nombre_ingrediente_activo: str = None, nom_quimico: str = None, denominacion_generica_prod: str = None, denominacion_distintiva_prod: str = None, fabricante: str = None, fecha_caducidad: date = None, lote_medicamento: str = None, forma_farmaceutica: str = None, condiciones_esp_transp: str = None, registro_sanitario_folio_autorizacion: str = None, permiso_importacion: str = None, folio_impo_vucem: str = None, num_cas: str = None, razon_social_emp_imp: str = None, num_reg_san_plag_cofepris: str = None, datos_fabricante: str = None, datos_formulador: str = None, datos_maquilador: str = None, uso_autorizado: str = None, valor_mercancia: Decimal | int = None, moneda: str = None, fraccion_arancelaria: str = None, uuid_comercio_ext: str = None, tipo_materia: str = None, descripcion_materia: str = None, documentacion_aduanera: DocumentacionAduanera | dict | Sequence[DocumentacionAduanera | dict] = None, guias_identificacion: GuiasIdentificacion | dict | Sequence[GuiasIdentificacion | dict] = None, cantidad_transporta: CantidadTransporta | dict | Sequence[CantidadTransporta | dict] = None, detalle_mercancia: DetalleMercancia | dict = None)[source]

Bases: ScalarMap

Nodo requerido para registrar detalladamente la información de los bienes y/o mercancías que se trasladan en los distintos medios de transporte.

Parameters:

bienes_transp – Atributo requerido para registrar la clave de producto de los bienes y/o mercancías que se trasladan en los distintos medios de transporte.
descripcion – Atributo requerido para detallar las características de los bienes y/o mercancías que se trasladan en los distintos medios de transporte.
cantidad – 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.
clave_unidad – 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.
peso_en_kg – 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.
clave_stcc – 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.
unidad – 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 – 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. 30/40/30cm.
material_peligroso – Atributo condicional para precisar que los bienes y/o mercancías que se trasladan son considerados o clasificados como material peligroso.
cve_material_peligroso – Atributo condicional para indicar la clave del tipo de material peligroso que se transporta de acuerdo a la NOM-002-SCT/2011.
embalaje – Atributo condicional para precisar la clave del tipo de embalaje que se requiere para transportar el material o residuo peligroso.
descrip_embalaje – 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.
sector_cofepris – 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.
nombre_ingrediente_activo – 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.
nom_quimico – 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.
denominacion_generica_prod – 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.
denominacion_distintiva_prod – 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 – 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.
fecha_caducidad – 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 uso dual que se traslada a través de los distintos medios de transporte. Se expresa en la forma AAAA-MM-DD.
lote_medicamento – 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.
forma_farmaceutica – 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.
condiciones_esp_transp – 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.
registro_sanitario_folio_autorizacion – 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.
permiso_importacion – 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.
folio_impo_vucem – 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 fertilizantes.
num_cas – 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.
razon_social_emp_imp – Atributo condicional para expresar el nombre o razón social de la empresa importadora de las sustancias tóxicas.
num_reg_san_plag_cofepris – 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).
datos_fabricante – 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.
datos_formulador – Atributo condicional para registrar el país y nombre o razón social de quien formula el ingrediente activo del plaguicida o fertilizante.
datos_maquilador – Atributo condicional para registrar el país y nombre o razón social de quien maquila el ingrediente activo del plaguicida o fertilizante.
uso_autorizado – Atributo condicional para registrar el uso autorizado del plaguicida o fertilizante de acuerdo a la regulación del país.
valor_mercancia – 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 – 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.
fraccion_arancelaria – 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.
uuid_comercio_ext – Atributo opcional para expresar el folio fiscal (UUID) del comprobante de comercio exterior que se relaciona.
tipo_materia – 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.
descripcion_materia – 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.
documentacion_aduanera – 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.
guias_identificacion – 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.
cantidad_transporta – 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.
detalle_mercancia – Nodo condicional para registrar especificaciones de los bienes y/o mercancías que se trasladan a través de los distintos medios de transporte.

class satcfdi.create.cfd.cartaporte31.Mercancias(peso_bruto_total: Decimal | int, unidad_peso: str, num_total_mercancias: int, mercancia: Mercancia | dict | Sequence[Mercancia | dict], peso_neto_total: Decimal | int = None, cargo_por_tasacion: Decimal | int = None, logistica_inversa_recoleccion_devolucion: str = None, autotransporte: Autotransporte | dict = None, transporte_maritimo: TransporteMaritimo | dict = None, transporte_aereo: TransporteAereo | dict = None, transporte_ferroviario: TransporteFerroviario | dict = None)[source]

Bases: ScalarMap

Nodo requerido para registrar la información de los bienes y/o mercancías que se trasladan en los distintos medios de transporte.

Parameters:

peso_bruto_total – 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.
unidad_peso – 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.
num_total_mercancias – 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.
mercancia – Nodo requerido para registrar detalladamente la información de los bienes y/o mercancías que se trasladan en los distintos medios de transporte.
peso_neto_total – Atributo condicional para registrar la suma de los valores indicados en el atributo “PesoNeto” del nodo “DetalleMercancia”.
cargo_por_tasacion – 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.
logistica_inversa_recoleccion_devolucion – 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.
autotransporte – 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.
transporte_maritimo – 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.
transporte_aereo – 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.
transporte_ferroviario – 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.

class satcfdi.create.cfd.cartaporte31.Ubicacion(tipo_ubicacion: str, rfc_remitente_destinatario: str, fecha_hora_salida_llegada: datetime, id_ubicacion: str = None, nombre_remitente_destinatario: str = None, num_reg_id_trib: str = None, residencia_fiscal: str = None, num_estacion: str = None, nombre_estacion: str = None, navegacion_trafico: str = None, tipo_estacion: str = None, distancia_recorrida: Decimal | int = None, domicilio: Domicilio | dict = None)[source]

Bases: ScalarMap

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.

Parameters:

tipo_ubicacion – 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.
rfc_remitente_destinatario – 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.
fecha_hora_salida_llegada – 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 AAAA-MM-DDThh:mm:ss.
id_ubicacion – 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.
nombre_remitente_destinatario – 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.
num_reg_id_trib – 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.
residencia_fiscal – 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.
num_estacion – 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.
nombre_estacion – 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.
navegacion_trafico – 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.
tipo_estacion – 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.
distancia_recorrida – 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 – 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.

class satcfdi.create.cfd.cartaporte31.CartaPorte(id_ccp: str, transp_internac: str, ubicaciones: Ubicacion | dict | Sequence[Ubicacion | dict], mercancias: Mercancias | dict, entrada_salida_merc: str = None, pais_origen_destino: str = None, via_entrada_salida: str = None, total_dist_rec: Decimal | int = None, registro_istmo: str = None, ubicacion_polo_origen: str = None, ubicacion_polo_destino: str = None, regimenes_aduaneros: str | Sequence[str] = None, figura_transporte: TiposFigura | dict | Sequence[TiposFigura | dict] = None)[source]

Bases: CFDI

Complemento para incorporar al Comprobante Fiscal Digital por Internet (CFDI), la información relacionada a los bienes y/o mercancías, ubicaciones de origen, puntos intermedios y destinos, así como lo referente al medio por el que se transportan; que circulen por vía terrestre, férrea, aérea o naveguen por vía marítima; además de incluir el traslado de hidrocarburos y petrolíferos.

Parameters:

id_ccp – 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.
transp_internac – Atributo requerido para expresar si los bienes y/o mercancías que son transportadas ingresan o salen del territorio nacional.
ubicaciones – 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 – Nodo requerido para registrar la información de los bienes y/o mercancías que se trasladan en los distintos medios de transporte.
entrada_salida_merc – Atributo condicional para precisar si los bienes y/o mercancías ingresan o salen del territorio nacional.
pais_origen_destino – 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.
via_entrada_salida – Atributo condicional para registrar la vía de ingreso o salida de los bienes y/o mercancías en territorio nacional.
total_dist_rec – 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.
registro_istmo – 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.
ubicacion_polo_origen – 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.
ubicacion_polo_destino – 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.
regimenes_aduaneros – 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.
figura_transporte – 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.

tag = '{http://www.sat.gob.mx/CartaPorte31}CartaPorte'

version = '3.1'