Complementos

Actualmente, FacturAPI soporta la emisión de todos los tipos de CFDI que existen así como todos los complementos del SAT. Puedes ver cómo cear los diferentes tipos de comprobantes en la referencia de Crear Factura y Crear Retención

note

Puedes insertar cualquier complemento agregando el XML correspondiente en el nodo “complements” de tus CFDI.

A continuación encontrarás un ejemplo de cómo insertar un complemento a una factura, en este caso se trata de un CFDI de traslado con complemento Carta Porte:

{
    "type": "T",
    "customer": {
      "legal_name": "GASERA NACIONAL",
      "tax_id": "ABC010101A19",
      "tax_system": "601",
      "address": {
        "country": "MEX",
        "zip": "06123"
      }
    },
    "items": [
      {
        "quantity": 2496,
        "product": {
          "description": "Gas licuado de petróleo",
          "product_key": "15111510",
          "unit_key": "LTR",
          "unit_name": "Litro",
          "price": 0,
          "taxes": []
        }
      }
    ],
    "complements": [
      {
        "type": "custom",
        "data": "<cartaporte20:CartaPorte Version=\"2.0\" TranspInternac=\"No\" TotalDistRec=\"69.80\">  <cartaporte20:Ubicaciones>    <cartaporte20:Ubicacion TipoUbicacion=\"Origen\" RFCRemitenteDestinatario=\"ABC010101A19\" NombreRemitenteDestinatario=\"GASERA NACIONAL S.A. DE C.V.\" FechaHoraSalidaLlegada=\"2023-09-05T07:38:36\">      <cartaporte20:Domicilio Calle=\"Av. Francisco I. Madero\" NumeroExterior=\"304\" Colonia=\"1630\" Localidad=\"07\" Municipio=\"020\" Estado=\"GUA\" Pais=\"MEX\" CodigoPostal=\"37494\"/>    </cartaporte20:Ubicacion>    <cartaporte20:Ubicacion TipoUbicacion=\"Destino\" RFCRemitenteDestinatario=\"ABC010101A19\" NombreRemitenteDestinatario=\"GASERA NACIONAL S.A. DE C.V.\" FechaHoraSalidaLlegada=\"2023-09-05T23:59:00\" DistanciaRecorrida=\"69.80\">      <cartaporte20:Domicilio Calle=\"Los Robledos\" NumeroExterior=\"114\" Colonia=\"0366\" Localidad=\"06\" Municipio=\"017\" Estado=\"GUA\" Pais=\"MEX\" CodigoPostal=\"36503\"/>    </cartaporte20:Ubicacion>  </cartaporte20:Ubicaciones>  <cartaporte20:Mercancias PesoBrutoTotal=\"1297.92\" UnidadPeso=\"KGM\" NumTotalMercancias=\"1\">    <cartaporte20:Mercancia BienesTransp=\"15111510\" Descripcion=\"GAS LP CARBURACION\" Cantidad=\"2250.00\" ClaveUnidad=\"LTR\" Unidad=\"LITROS\" MaterialPeligroso=\"Sí\" CveMaterialPeligroso=\"1075\" Embalaje=\"Z01\" DescripEmbalaje=\"No aplica\" PesoEnKg=\"1297.92\" ValorMercancia=\"22339.2000\" Moneda=\"MXN\"/>    <cartaporte20:Autotransporte PermSCT=\"TPAF09\" NumPermisoSCT=\"000000\">      <cartaporte20:IdentificacionVehicular ConfigVehicular=\"C2\" PlacaVM=\"HB2712P\" AnioModeloVM=\"2018\"/>      <cartaporte20:Seguros AseguraRespCivil=\"SEGURIMEX SEGUROS\" PolizaRespCivil=\"3-693750-71\" AseguraMedAmbiente=\"HDK SEGUROS\" PolizaMedAmbiente=\"10782483\"/>    </cartaporte20:Autotransporte>  </cartaporte20:Mercancias>  <cartaporte20:FiguraTransporte>    <cartaporte20:TiposFigura TipoFigura=\"01\" RFCFigura=\"PERE120817836\" NombreFigura=\"PEREZ RENTERIA EUSEBIO ADOLFO\" NumLicencia=\"BT5648\"/>  </cartaporte20:FiguraTransporte></cartaporte20:CartaPorte>"
      }
    ],
    "pdf_custom_section": "<h3>Complemento Carta Porte</h3><br><table><thead><th>Transporte Internacional</th><th>Tipo de Transporte Internacional</th><th>Vía de Transporte Internacional</th><th>País de Origen o Destino</th><th>Total distancia recorrida</th></tr></thead><tbody><tr><td>No</td><td></td><td></td><td></td><td></td></tr></tbody></table><br><br><table><thead><tr><th>Detalle del Transporte</th></tr><tr><th>Permiso SCT</th><th>Número de Permiso SCT</th><th>Configuración Vehicular / Tipo de remolque</th><th>Placa</th><th>Año</th></tr></thead><tbody><tr><td>TPAF09 - Transporte privado de carga.</td><td>000000</td><td>C2 - Camión Unitario (2 llantas en el eje delantero y 4 llantas en el eje trasero)</td><td>HB2712P</td><td>2018</td></tr></tbody></table><br><table><thead><tr><th>Aseguradora responsabilidad civil</th><th>Póliza responsabilidad civil</th><th>Aseguradora medio ambiente</th><th>Póliza medio ambiente</th><th>Aseguradora carga</th><th>Póliza carga</th><th>Prima seguro</th></tr></thead><tbody><tr><td>SEGURIMEX SEGUROS</td><td>3-693750-71</td><td>HDK SEGUROS</td><td>10782483</td><td></td><td></td><td></td></tr></tbody></table><br><br><table><thead><tr><th>Origen / Destino</th></tr><tr><th></th><th>RFC</th><th>Nombre</th><th>Fecha de Salida o Llegada</th><th>Domicilio</th><th>Distancia Recorrida</th></tr></thead><tbody><tr><td>Origen</td><td>ABC123456789</td><td>Gasera Nacional S.A. DE C.V.</td><td>2023-09-05T07:38:36</td><td>Av. Francisco I. Madero No. 304, Central de Abastos, C.P. 37494, León de los Aldama, Guanajuato, México</td><td></td></tr><tr><td>Destino</td><td>ABC123456789</td><td>Gasera Nacional S.A. DE C.V.</td><td>2023-09-05T23:59:00</td><td>Los Robledos No. 14, Zona Centro, 36503, IRAPUATO, IRAPUATO, GUA</td><td>69.80</td></tr></tbody></table><br><br><table><thead><tr><th>Figuras de Trasporte</th></tr><tr><th></th><th>RFC</th><th>Nombre</th><th>Licencia</th><th>Domicilio</th></tr></thead><tbody><tr><td>01 - Operador</td><td>PERE120817836</td><td>PEREZ RENTERIA EUSEBIO ADOLFO</td><td>BT5648</td><td>HIDALGO 314, 37260, León, León</td></tr></tbody></table><br><br><table><thead><tr><th>Mercancía</th></tr><tr><th>Cantidad</th><th>Unidad</th><th>Clave Producto/Servicio</th><th>Tipo Material Peligroso</th><th>Embalaje</th><th>Peso Kg</th><th>Valor Mercancía</th></tr></thead><tbody><tr><td>2250.00</td><td>LTR - LITROS</td><td>15111510 - Gas licuado de petróleo</td><td>1075 - GASES LICUADOS DEL PETROLEO</td><td>Z01 - No aplica</td><td>1297.92</td><td>22339.2000</td></tr></tbody></table>"
}

tip

Al insertar un complemento, nosotros lo agregaremos al xml en el momento del timbrado; debido a que el SAT no requiere que la información de todos los complementos se imprima en el pdf, solo aparecerá en el xml. Si requieres que determinada información del complemento se agregue al pdf, puedes utilizar pdf_custom_section.