789 FACTURACIÓN - CFDI 3.3
Facturas
Complementos
Addendas
Catálogos
Catálogos Carta Porte

Facturas ingresos con addenda MAVI

URL PRUEBAS: POST https://facturacion.789.mx/api/test/factura/crear

URL PRODUCCIÓN: POST https://facturacion.789.mx/api/factura/crear

Argumento Tipo Default Descripción
main Contiene los datos generales de la factura y los datos del emisor.
razonSocial string none Nombre ó Razón social del emisor.
rfc
requerido 		string none RFC del emisor.
12 dígitos para persona moral y 13 dígitos para persona física.
tipo
requerido 		string none Tipo de comprobante (ingreso, egreso, traslado, nomina, pago).
Para este tipo de comprobante enviar ingreso
moneda string MXN Código de la moneda, acorde al estándar ISO 4217
cambio decimal 1.0 Tipo de cambio conforme a la moneda usada. Representa el número de pesos mexicanos que equivalen a una unidad de la moneda señalada.
formaDePago
requerido 		string none Código de la forma de pago según el catálogo del SAT.
metodoDePago
requerido 		string none Código del método de pago según el catálogo del SAT.
PUE. Pago en una sola exhibición
PPD. Pago en parcialidades o diferido
folio string '' Número de folio asignado por la empresa para control interno.
serie string '' Serie. De 1 a 25 caracteres designados por la empresa para control interno y sin validez fiscal.
total
requerido 		decimal none Importe total facturado con impuestos incluido.
subtotal
requerido 		decimal none Importe total facturado antes de impuestos.
uso
requerido 		string none Clave del uso comprobante según el catálogo del SAT.
fechaEmision date now()
2025-04-18T15:31:19		 Campo opcional para indicar la FECHA de EMISIÓN de la factura, puede ser hasta 48hrs hacia atras de la fecha actual.
Debe cumplir el siguiente formato "Y-m-d\TH:i:s"
direccionFiscal string '' Domicilio fiscal del emisor.
direccionFiscal.calle string '' Calle del emisor.
direccionFiscal.num_ext string '' Número exterior (númerio visible desde la calle) del domicilio del emisor.
direccionFiscal.num_int string '' Número interior del domicilio del emisor.
direccionFiscal.colonia string '' Colonia del domicilio del emisor.
direccionFiscal.cp
requerido 		string '' Código Postal del domicilio del emisor.
direccionFiscal.ciudad string '' Ciudad del domicilio del emisor.
direccionFiscal.localidad string '' Delegación o Municipio del domicilio del emisor.
direccionFiscal.estado string '' Estado del domicilio del emisor.
direccionFiscal.pais string '' País del domicilio del emisor.
receptor Datos del Receptor
razon_social string none Nombre o Razón social del receptor
rfc
requerido 		string none RFC del receptor.
12 dígitos para persona moral y 13 dígitos para persona física.
email string none Correo electrónico del receptor, debe ser válido.
direccion string '' Domicilio fiscal del receptor.
direccion.calle string '' Calle del receptor.
direccion.num_ext string '' Número exterior (númerio visible desde la calle) del domicilio del receptor.
direccion.num_int string '' Número interior del domicilio del receptor.
direccion.colonia string '' Colonia del domicilio del receptor.
direccion.codigo_postal
requerido 		string '' Código Postal del domicilio del receptor.
direccion.ciudad string '' Ciudad del domicilio del receptor.
direccion.estado string '' Estado del domicilio del receptor.
direccion.pais string '' País del domicilio del receptor.
conceptos Conjuto de datos de los productos o conceptos a facturar
conceptos[].nombre
requerido 		string none Nombre del producto o servicio
conceptos[].unidad string none Descripción de la unidad de medida
conceptos[].medidaKey
requerido 		string none Clave de la unidad de medida segun el catálogo del SAT
conceptos[].productKey
requerido 		string none Clave del producto segun el catálogo del SAT
conceptos[].precioUnitario
requerido 		decimal none Precio unitario del producto o servicio, debe ser mayor a 0, solo se permiete el número de decimales que indica el catálogo de monedas del SAT
conceptos[].cantidad integer, decimal 1 Cantidad de productos o servicios vendidos, debe ser mayor a 0
conceptos[].total
requerido 		decimal none Importe total a factura del producto o servicio con impuestos incluidos, debe ser mayor a 0, solo se permiete el número de decimales que indica el catálogo de monedas del SAT
conceptos[].descuento decimal none Descuento que se aplicará al producto o servicio, debe ser mayor a 0, solo se permiete el número de decimales que indica el catálogo de monedas del SAT
conceptos[].impuestos Conjunto [] Conjuto de datos con los impuestos federales a aplicar, este nodo puede omitirse sí no es necesario deducir impuestos.
conceptos[].impuestos[].tasa
requerido 		decimal none Tasa del impuesto a aplicar, debe ser en decimal, ej. 16% se debe enviar como 0.16
conceptos[].impuestos[].tipo
requerido 		string none Indica el tipo de impuesto a aplicar (IVA, ISR, IEPS)
conceptos[].impuestos[].factor string Tasa Indica el factor del impuesto a aplicar (Tasa, Cuota, Exento)
conceptos[].impuestos[].retencion
requerido 		boolean none Indica si se trata de una retención
addendas Conjuto de datos de las addendas a agregar al CFDI
addendas.mavi
requerido 		Object none Conjunto de datos para la addenda MAVI
fecha
requerido 		date '' Fecha de registro del movimiento con MAVI.
rfcProveedor
requerido 		string '' R.F.C. del proveedor de productos o servicios MAVI
numProveedor
requerido 		string '' Número del proveedor de productos o servicios MAVI
numPedido
requerido 		string '' Número del pedido MAVI
codMoneda
requerido 		string '' Mondea con la que realizó la operación con MAVI
montoTotal
requerido 		decimal '' Monto de la operación con MAVI
iva
requerido 		decimal '' Importe total equivalente al IVA de la operación con MAVI
porcentajeIVA
requerido 		decimal '' Porcentaje del IVA de la operación con MAVI
numFactura
requerido 		string '' Número de factura correspondiente al control interno con MAVI
serie
requerido 		string '' Serie de la factura correspondiente al control interno con MAVI
folio
requerido 		string '' Folio de la factura correspondiente al control interno con MAVI
ipn Parametro opcional, permite recibir autonotificación del status del CFDI.
Ver ejemplo
ipn.url
requerido 		url none Endpoint o api donde ser recibiran las notificaciones de los cambios de status del CFDI
ipn.data_request
requerido 		string, object none Conjunto de datos de control interno.
Estos datos tal cual como sean enviados serán recibidos por el Endpoint o api.		 
data: {
    "main":{
        "razonSocial":"EJIDO RODRIGUEZ PUEBLA SA DE CV",
        "rfc":"IIA040805DZ4",
        "tipo": "ingreso",
        "moneda": "mxn",
        "folio": "88",
        "serie": "B",
        "total": "18560",
        "direccionFiscal":{
            "subtotal": "16000",
            "calle":"1RO DE MAYO",
            "num_ext":"153-A",
            "num_int":null,
            "colonia":"SAN LUIS TLATILCO",
            "ciudad":"NAUCALPAN DE JUAREZ",
            "cp":"53580",
            "estado":"Estado de México",
            "pais":"MÉXICO",
            "localidad":"NAUCALPAN DE JUAREZ",
        }
    },
    "receptor": {
        "razon_social": "MAVI FARMACEUTICA S.A. DE C.V.",
        "rfc": "MFA840320DX0",
        "email": "prueba@mavi.com.mx",
        "direccion": {
            "calle": "AGUSTIN DELGADO",
            "colonia": "TRANSITO",
            "ciudad": "CIUDAD DE MEXICO",
            "estado": "Ciudad de México",
            "codigo_postal": "06820",
            "pais": "MEXICO",
            "num_ext": "39",
            "num_int": "0"
        }
    },
    "conceptos": [
        {
            "nombre": "REPARACION CONSISTENTE",
            "total": "18560",
            "unidad": "Unidad",
            "medidaKey": "E48",
            "productKey": "81111801",
            "precioUnitario": "16000",
            "cantidad": "1",
            "impuestos": [
                {
                    "tasa": 0.16,
                    "tipo": "IVA",
                    "retencion": false
                }
            ]
        }
    ],
    "addendas": {
        "mavi": {
            "fecha": "2019-04-01",
            "rfcProveedor": "IIA040805DZ4",
            "numProveedor": "49717",
            "numPedido": "51444",
            "codMoneda": "MXN",
            "montoTotal": "18560",
            "iva": "2560.00",
            "porcentajeIVA": "16.00",
            "numFactura": "A902",
            "serie": "A",
            "folio": "902",
        }
    },
    "ipn": {
       "url":"http://***.cloudwaysapps.com/api/requestStatus",
       "data_request": 1,
    }
}