URL PRUEBAS: POST https://facturacion.789.mx/api/v40/test/factura/crear
URL PRODUCCIÓN: POST https://facturacion.789.mx/api/v40/factura/crear
| 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 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 |
| condicionesDePago | string | none | Expresa las condiciones comerciales aplicables para el pago del comprobante fiscal digital por Internet. Este atributo puede ser condicionado mediante atributos o complementos |
| 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-16T04:54:50 |
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" |
| confirmacion | string | none | Registra la clave de confirmación que entregue el PAC para expedir el comprobante con importes grandes, con un tipo de cambio fuera del rango establecido o con ambos casos. Es requerido cuando se registra un tipo de cambio o un total fuera del rango establecido. |
| 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. |
| observaciones | string | none | Campo exclusivo para la representación impresa (PDF), se puede enviar un HTML básico como negritas y/o saltos de linea "<br>" |
| 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. |
| NUEVO global | Nodo opcional, precisa la información relacionada con el comprobante global. | ||
|
NUEVO
periodicidad
requerido |
string | none | Expresa el período al que corresponde la información del comprobante global. |
|
NUEVO
meses
requerido |
string | none | Expresa el mes o los meses al que corresponde la información del comprobante global. |
|
NUEVO
anio
requerido |
string | none | Expresa el año al que corresponde la información del comprobante global. |
| 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. |
| 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. |
|
NUEVO
uso
requerido |
string | none | 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. |
|
NUEVO
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 |
| 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[].cantidad | integer, decimal | 1 | Cantidad de productos o servicios vendidos, debe ser mayor a 0 |
|
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[].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[].total | decimal | conceptos[].cantidad * conceptos[].precioUnitario | Importe total a factura del producto o servicio antes de impuestos, 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 |
| NUEVO conceptos[].NumeroPedimento | array | none |
Señala la información aduanera aplicable cuando se trate de ventas de primera mano de mercancías importadas o se trate de operaciones de comercio exterior con bienes o servicios.
Expresar el número del pedimento que ampara la importación del bien que se expresa en el siguiente formato: últimos 2 dígitos del año de validación seguidos por dos espacios, 2 dígitos de la aduana de despacho seguidos por dos espacios, 4 dígitos del número de la patente seguidos por dos espacios, 1 dígito que corresponde al último dígito del año en curso, salvo que se trate de un pedimento consolidado iniciado en el año inmediato anterior o del pedimento original de una rectificación, seguido de 6 dígitos de la numeración progresiva por aduana. |
| NUEVO conceptos[].CuentaPredial | array | none | Señala el número de cuenta predial con el que fue registrado el inmueble, en el sistema catastral de la entidad federativa de que trate, o bien para incorporar los datos de identificación del certificado de participación inmobiliaria no amortizable. |
| addendas | Conjuto de datos de las addendas a agregar al CFDI | ||
|
walmart
requerido |
string | none |
Conjunto de datos para la addenda WALMART Ejemplo: UNB+UNOB:1+EDIID:ZZ+925485MX00:8+061231:1000+3945'UNH+1+INVOIC:D:01B:UN:AMC002'BGM+380+092761+9'DTM+137:20061229073404:204'FTX+ZZZ+++OCHO MIL OCHOCIENTOS TREINTA Y DOS PESOS 00/100 M.N.'RFF+ON:9250113699'DTM+171:20061229:102'RFF+BT:ABC'RFF+ATZ:0001'NAD+BY+7507003100001::9++NUEVA WAL MART DE MEXICO S DE RL DE:CV+NEXTENGO NO 78:SANTA CRUZ ACAYUCAN+AZCAPOTZALCO+DF+02770'RFF+GN:NWM9709244W4'NAD+SU+++EL PATITO,SA DE CV+NORTE 45,Num. 614: INDUSTRIAL VALLEJO +AZCAPOTZALCO+DF+23000'RFF+GN:EPA881230M11'RFF+IA:185853950'NAD+ST+7507003105136::9++C.D. SANTA BARBARA 7482+CARR.CUATITLAN-TEOLOYUCAN 1000:SANTA BARBARA+CUAUTITLAN IZCALLI+EDOMX+54713'CUX+2:MXN:4'PAT+1++5:3:D:30'LIN+1++7501026045063:SRV::9'IMD+F++:::PATO DE HULE'QTY+47:768:EA'MOA+203:7680.00'PRI+AAA:10.00::::EA'TAX+7+VAT+++:::15.0'MOA+124:1152.00'UNS+S'CNT+2:1'MOA+9:8832.00'MOA+79:7680.00'MOA+125:7680.00'TAX+7+VAT+++:::15.00'MOA+124:1152.00'UNT+31+1'UNZ+1+3945' |