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-12-01T16:50:49 |
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. |
| 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,
}
}