Skip to content

createNodeMercancia

Este método permite agregar una nueva entrada al nodo cartaporte31:Mercancias. Cada entrada representa una mercancía individual transportada, incluyendo detalles como:

  • Clasificación arancelaria

  • Datos físicos (peso, dimensiones)

  • Identificación sanitaria y aduanera

  • Embalaje y condiciones especiales

  • Cantidades transportadas por tramo

  • Documentación asociada y más

Este nivel de detalle es crucial para cumplir con los requerimientos del complemento Carta Porte 3.1, especialmente en operaciones complejas como comercio exterior, sector salud o traslado de mercancía peligrosa.

ts
cartaporte.createNodeMercancia({
  mercancia: {...},
  documentacionAduanera: [...],
  cantidadTransporta: [...],
  guiasIdentificacion: [...],
  detalleMercancia: {...},
});

Subpropiedad: mercancia

Contiene los datos comerciales, físicos y regulatorios del producto transportado. Incluye campos obligatorios como clave del bien (bienesTransp), cantidad, peso, descripción, así como opcionales relacionados con sanidad, comercio exterior o seguridad.

ts
cartaporte.createNodeMercancia({
  mercancia: { 
    bienesTransp: "11121900", 
    cantidad: 1, 
    claveUnidad: "KGM", 
    descripcion: "mercancia", 
    pesoEnKg: 15.048, 
    valorMercancia: 109.08, 
    moneda: "MXN", 
    dimensiones: "30/40/30cm", 
    unidad: "KGM", 
    fraccionArancelaria: "0101290300", 
    uuidComercioExt: "a3f01bc9-27e0-4123-8c6b-efb2138f61fd", 
    tipoMateria: "03", 
    descripcionMateria: "Materia terminada (producto terminado)", 
    materialPeligroso: "Sí", 
    cveMaterialPeligroso: "123", 
    embalaje: "4D", 
    descripEmbalaje: "Cajas de Madera contrachapada", 
    sectorCofepris: "01", 
    nombreIngredienteActivo: "Nombre", 
    nomQuimico: "Nombre quimico", 
    denominacionGenericaProd: "Denominacion generica", 
    denominacionDistintivaProd: "Denominacion distintiva", 
    fabricante: "Nombre fabricante", 
    fechaCaducidad: "2025-06-19", 
    loteMedicamento: "L-2304", 
    formaFarmaceutica: "01", 
    condicionesEspTransp: "02", 
    registroSanitarioFolioAutorizacion: "123456789", 
    permisoImportacion: "0987", 
    folioImpoVucem: "67378387", 
    numCas: "567", 
    razonSocialEmpImp: "Nombre o razon social", 
    numRegSanPlagCofepris: "33332", 
    datosFabricante: "Datos", 
    datosFormulador: "Datos", 
    datosMaquilador: "Maquilador", 
    usoAutorizado: "Au67890", 
  }, 
  documentacionAduanera: [...],
  cantidadTransporta: [...],
  guiasIdentificacion: [...],
  detalleMercancia: {...},
});

Parámetros disponibles

A continuación se muestra una tabla con las propiedades que acepta este método:

PropiedadTipoDescripción
bienesTranspc_ClaveProdServClave del bien transportado según el catálogo del SAT.
cantidadstring - numberCantidad de unidades de la mercancía.
claveUnidadc_ClaveUnidadClave de unidad de medida del bien.
descripcionstringDescripción general de la mercancía.
pesoEnKgstring - numberPeso de la mercancía en kilogramos.
valorMercanciastring - number(opcional) Valor monetario total de la mercancía.
monedac_Moneda(opcional) Moneda en la que se expresa el valor.
dimensionesstring(opcional) Dimensiones físicas del bien con formato 00/00/00(cm-plg)
unidadstring(opcional) Unidad específica de la mercancía.
fraccionArancelariastring(opcional) Fracción arancelaria para comercio exterior.
uuidComercioExtstringRequerido si existe fraccion arancelaria. UUID del pedimento de comercio exterior.
tipoMateriac_TipoMateria(opcional) Clave del tipo de materia.
descripcionMateriastringRequerido si existe tipo de materia. Descripción del tipo de materia.
materialPeligroso - No(opcional) Indica si la mercancía es material peligroso.
cveMaterialPeligrosoc_MaterialPeligrosoRequerido si la clave del bienTransp es material peligroso. Clave que identifica el tipo de material peligroso.
embalajestringRequerido si la clave del bienTransp es material peligroso. Clave del tipo de embalaje utilizado.
descripEmbalajestringRequerido si la clave del bienTransp es material peligroso. Descripción del tipo de embalaje.
sectorCofeprisc_SectorCOFEPRIS(opcional) Sector regulado por COFEPRIS.
nombreIngredienteActivostringRequerido si existe sectorCofepris. Nombre del ingrediente activo.
nomQuimicostringRequerido si existe sectorCofepris. Nombre químico del producto.
denominacionGenericaProdstringRequerido si existe sectorCofepris. Denominación genérica del producto.
denominacionDistintivaProdstringRequerido si existe sectorCofepris. Denominación distintiva o comercial del producto.
fabricantestringRequerido si existe sectorCofepris. Nombre del fabricante del producto.
fechaCaducidadstringRequerido si existe sectorCofepris. Fecha de caducidad del producto en formato AAAA-MM-DD
formaFarmaceuticac_FormaFarmaceuticaRequerido si el valor sectorCofepris es "01". Clave de la forma farmacéutica.
condicionesEspTranspc_CondicionesEspecialesRequerido si el valor sectorCofepris es "01"/"02"/"03". Clave de condiciones especiales de transporte.
registroSanitarioFolioAutorizacionstringRequerido si el valor sectorCofepris es "01"/"03". Folio o número de autorización sanitaria.
permisoImportacionstringRequerido si el valor sectorCofepris es "01"/"02"/"03". Clave del permiso de importación.
folioImpoVucemstringRequerido si el valor sectorCofepris es distinto a "03".Folio del permiso en VUCEM.
numCasstringRequerido si el valor sectorCofepris es "04". Número CAS del componente químico.
razonSocialEmpImpstringRequerido si el valor sectorCofepris es "04". Nombre o razón social del importador.
numRegSanPlagCofeprisstringRequerido si el valor sectorCofepris es "04"/"05". Número de registro sanitario o plaguicida.
datosFabricantestringRequerido si el valor sectorCofepris es "05". Información adicional sobre el fabricante.
datosFormuladorstringRequerido si el valor sectorCofepris es "05". Información del formulador.
datosMaquiladorstringRequerido si el valor sectorCofepris es "05". Información del maquilador.
usoAutorizadostringRequerido si el valor sectorCofepris es "05". Clave o descripción del uso autorizado del producto.

Subpropiedad: documentacionAduanera

Arreglo que representa los documentos aduaneros asociados (como pedimentos). Se usa especialmente en operaciones de importación/exportación.

Esta propiedad es opcional

ts
cartaporte.createNodeMercancia({
  mercancia: {...},
   documentacionAduanera: [ 
    { 
      tipoDocumento: "01", 
      numPedimento: "23  43  0472  8000448", 
      rfcImpo: "EKU9003173C9", 
      identDocAduanero: "1234567890", 
    }, 
  ], 
  cantidadTransporta: [...],
  guiasIdentificacion: [...],
  detalleMercancia: {...},
});

Parámetros disponibles

A continuación se muestra una tabla con las propiedades que acepta este método:

PropiedadTipoDescripción
tipoDocumentoc_DocumentoAduaneroClave que indica el tipo de documento aduanero.
numPedimentostring(opcional) Número de pedimento aduanal.
rfcImpostring(opcional) RFC del importador.
identDocAduanerostring(opcional) Identificador del documento aduanero.

Subpropiedad: cantidadTransporta

Lista que permite detallar cuántas unidades se trasladan por cada tramo (origen/destino). Especialmente útil para identificar el flujo logístico de cada mercancía.

Esta propiedad es opcional

ts
cartaporte.createNodeMercancia({
  mercancia: {...},
  documentacionAduanera: [...],
  cantidadTransporta: [ 
    { 
      cantidad: 1, 
      idOrigen: "80100", 
      idDestino: "56789", 
      cvesTransporte: "01", 
    }, 
  ], 
  guiasIdentificacion: [...],
  detalleMercancia: {...},
});

Parámetros disponibles

A continuación se muestra una tabla con las propiedades que acepta este método:

PropiedadTipoDescripción
cantidadstring - numberCantidad de mercancía transportada entre origen y destino.
idOrigenstringIdentificador de la ubicación de origen.
idDestinostringIdentificador de la ubicación de destino.
cvesTransportec_CveTransporteClave del tipo de transporte utilizado.

Subpropiedad: guiasIdentificacion

Permite registrar números de guía o documentos que identifican la mercancía individualmente.

Esta propiedad es opcional

ts
cartaporte.createNodeMercancia({
  mercancia: {...},
  documentacionAduanera: [...],
  cantidadTransporta: [...],
  guiasIdentificacion: [ 
    {
      numeroGuiaIdentificacion: "1234567890",
      descripGuiaIdentificacion: "328",
      pesoGuiaIdentificacion: 555.001,
    },
  ],
  detalleMercancia: {...},
});

Parámetros disponibles

A continuación se muestra una tabla con las propiedades que acepta este método:

PropiedadTipoDescripción
numeroGuiaIdentificacionstringNúmero o folio de la guía de identificación de la mercancía.
descripGuiaIdentificacionstringDescripción de la guía o del contenido que identifica.
pesoGuiaIdentificacionstring - numberPeso asociado a la guía de identificación, en kilogramos.

Subpropiedad: detalleMercancia

Contiene detalles físicos adicionales sobre la mercancía, como pesos netos y brutos, tara y número de piezas.

Esta propiedad es opcional

ts
cartaporte.createNodeMercancia({
  mercancia: {...},
  documentacionAduanera: [...],
  cantidadTransporta: [...],
  guiasIdentificacion: [...],
  detalleMercancia: {
    pesoBruto: 5,
    pesoNeto: 3,
    pesoTara: 2,
    unidadPesoMerc: "KGM",
    numPiezas: 1,
  },
});

Parámetros disponibles

A continuación se muestra una tabla con las propiedades que acepta este método:

PropiedadTipoDescripción
pesoBrutostring - numberPeso bruto de la mercancía, incluyendo empaque.
pesoNetostring - numberPeso neto de la mercancía, sin empaque.
pesoTarastring - numberDiferencia entre el peso bruto menos el peso neto.
unidadPesoMercc_ClaveUnidadPesoUnidad de medida del peso.
numPiezasstring - number(opcional) Número total de piezas físicas de la mercancía.

Lanzado bajo la licencia MIT.