Documentación - 789 Facturación

789 FACTURACIÓN - CFDI 4.0

Facturas

Timbrado Masivo

Complementos

Addendas

Catálogos

Catálogos Comercio Exterior

Facturas de Egresos (Notas de credito)

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

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

Información requerida

Argumento	Tipo	Default	Descripción
main			Contiene los datos generales de la factura y los datos del emisor.
NUEVO regimen requerido	string	none	Incorpora la clave del régimen del contribuyente emisor al que aplicará el efecto fiscal de este comprobante
NUEVO exportacion requerido	string	01	Expresa si el comprobate ampara una operación de exportación.
razonSocial	string	none	Nombre ó Razón social del emisor. Nota: en la version 4.0 debe ser el nombre tal cual como fueron registrados ante el SAT
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 egreso
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. Debe ser igual al documento relacionado
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 Debe ser igual al documento relacionado
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.
fechaEmision	date	now() 2025-04-16T05:00:55	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"
NUEVO fac_atr_adquirente	string	none	Expresa el número de operación proporcionado por el SAT cuando se trate de un comprobante a través de un PCECFDI o un PCGCFDISP.
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.
NUEVO 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
NUEVO razon_social requerido	string	none	Nombre o Razón social del receptor Nota: en la version 4.0 debe ser el nombre tal cual como fueron registrados ante el SAT
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.
NUEVO num_reg_id_trib	string	none	Expresa el número de registro de identidad fiscal del receptor cuando sea residente en el extranjero. Es requerido cuando se incluya el complemento de comercio exterior.
NUEVO residencia_fiscal	string	none	Registra la clave del país de residencia para efectos fiscales del receptor del comprobante, cuando se trate de un extranjero, y que es conforme con la especificación ISO 3166-1 alpha-3. Es requerido cuando se incluya el complemento de comercio exterior o se registre el atributo num_reg_id_trib.
NUEVO regimen requerido	string	none	Incorpora la clave del régimen fiscal del contribuyente receptor al que aplicará el efecto fiscal de este comprobante.
uso	string	G02	Clave del uso comprobante según el catálogo del SAT.
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 concetos a facturar. Por disposición de SAT en este tipo de documento, solo se permite uno, en el cual se debe detallar todos los casos.
conceptos[].nombre requerido	string	none	Nombre del producto o servicio
conceptos[].unidad	string	none	Descripción de la unidad de medida. Por disposición de SAT en este tipo de documento siempre se debe de enviar 'ACTIVIDAD'
conceptos[].medidaKey requerido	string	none	Clave de la unidad de medida. Por disposición de SAT en este tipo de documento siempre se debe de enviar 'ACT'
conceptos[].productKey requerido	string	none	Clave del producto. Por disposición de SAT en este tipo de documento siempre se debe de enviar '84111506'
NUEVO conceptos[].no_id	string	none	Expresa el número de parte, identificador del producto o del servicio, la clave de producto o servicio, SKU o equivalente, propia de la operación del emisor, amparado por el presente concepto. Opcionalmente se puede utilizar claves del estándar GTIN.
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
NUEVO conceptos[].objeto_imp requerido	string	none	Expresa si la operación comercial es objeto o no de impuesto. 01.- No objeto de impuesto 02.- Si objeto de impuesto 03.- Si objeto de impuesto y no obligado al desglose
NUEVO conceptos[].impuestos	Object	none	Conjuto de datos con los impuestos federales a aplicar, este nodo puede omitirse sí no es necesario deducir impuestos.
NUEVO conceptos[].impuestos.traslados	Array	[]	Asenta los impuestos trasladados aplicables al presente concepto
NUEVO conceptos[].impuestos.traslados[].base requerido	decimal	none	Señala la base para el cálculo del impuesto, la determinación de la base se realiza de acuerdo con las disposiciones fiscales vigentes. No se permiten valores negativos.
NUEVO conceptos[].impuestos.traslados[].impuesto requerido	string	none	Señala la clave del tipo de impuesto trasladado aplicable al concepto.
NUEVO conceptos[].impuestos.traslados[].tipo requerido	string	none	Señala la clave del tipo de factor que se aplica a la base del impuesto.
NUEVO conceptos[].impuestos.traslados[].tasa_couta	decimal	none	Señala el valor de la tasa o cuota del impuesto que se traslada para el presente concepto. Es requerido cuando el atributo tipo tenga una clave que corresponda a Tasa o Cuota.
NUEVO conceptos[].impuestos.traslados[].importe	decimal	none	Señala el importe del impuesto trasladado que aplica al concepto. No se permiten valores negativos. Es requerido cuando tipo sea Tasa o Cuota.
NUEVO conceptos[].impuestos.retenciones	Array	[]	Asenta las retenciones de impuestos aplicable al presente concepto
NUEVO conceptos[].impuestos.retenciones[].base requerido	decimal	none	Señala la base para el cálculo de la retención, la determinación de la base se realiza de acuerdo con las disposiciones fiscales vigentes. No se permiten valores negativos.
NUEVO conceptos[].impuestos.retenciones[].impuesto requerido	string	none	Señala la clave del tipo de impuesto retenido aplicable al concepto.
NUEVO conceptos[].impuestos.retenciones[].tipo requerido	string	none	Señala la clave del tipo de factor que se aplica a la base del impuesto.
NUEVO conceptos[].impuestos.retenciones[].tasa_couta requerido	decimal	none	Señala la tasa o cuota del impuesto que se retiene para el presente concepto.
NUEVO conceptos[].impuestos.retenciones[].importe requerido	decimal	none	Señala el importe del impuesto retenido que aplica al concepto. No se permiten valores negativos
relation	array	none	Documentos relacionados a la factura.
relation[].tipo	array	none	Código de tipo relación entre facturas según el catálogo del SAT.
relation[].related	array	none	Conjunto de datos con uno o más folios fiscales (UUID) de las facturas relacionadas. Este campo es obligatorio si el campo 'relation' existe.