Herramientas de usuario

Herramientas del sitio


datos-soportados-servicio-conector

Catálogo de Datos Soportados

El servicio de iFactura y el conector soportan los siguientes datos, clasificados de la siguiente manera:

Datos de la Factura

Campo Descripción Req. Función
serie Serie deseada para la factura. NO NF
folio Folio deseado para la factura. NO NF
RegimenFiscal Régimen Fiscal con el que se está facturando. SI NF
LugarExpedicion Lugar donde se expide la factura. Generalmente se utiliza sólo la ciudad y el estado. SI NF
Moneda Tipo de moneda de la transacción. Para pesos utilizar MXN. Para dólares USD. SI NF
tipoDeComprobante Clave que identifica el tipo de comprobante deseado, el cual depende del Catálogo de Comprobantes [0-8]. SI NF
metodoDePago Método de pago. Por ejemplo: efectivo, cheque, transferencia, etc. Si NF
NumCtaPago Los últimos 4 dígitos del número de cuenta del receptor de la factura. En caso de que no aplique o no se conozcan no es necesario que se coloque este elemento en el archivo CSV. NO NF
condicionesDePago Condiciones de pago. Por ejemplo: “crédito a 60 días”, “Contado”, ect. NO NF
comentarios Comentarios que aparecerán en el XML y en la representación impresa abajo del importe con letra. NO NF
numero_de_pago Número de pago en el caso de pagos en parcialidades. Si es pago en una sola exhibición entonces colocar un “1”. SI NF
cantidad_de_pagos Cantidad toal de pagos en el caso de pagos en parcialidades. Si es pago en una sola exhibición entonces colocar un “1”. SI NF
ret_iva Importe de la Retención de IVA. NO NF
ret_isr Importe de la Retención de ISR. NO NF
totalTrasladado Importe del Total de IVA. NO NR\NF
impuesto_extra Otros impuestos, como el ISH. NO NR\NF
numero_venta Número de venta para mostrar sólo en el PDF. NO NF
numero_vendedor Número de vendedor para mostrar sólo en el PDF. NO NF
no_sucursal Número de Sucursal de acuerdo al registro dentro de la cuenta. NO NF
total Monto total de la factura despues de impuestos, retenciones y descuentos. NO NR\NF
subTotal Suma de los importes de todos los conceptos antes de impuestos, retenciones y descuentos. NO NR\NF
descuento Descuento aplicado a la factura de manera global. NO NR\NF
motivoDescuento Motivo del descuento global aplicado a la factura. NO NR\NF
<cuenta> (Metadato) Nombre de la cuenta a utilizar. NO NR\NF
<user> (Metadato) Usuario de la cuenta a utilizar. NO NR\NF
<password> (Metadato) Contraseña del usuario de la cuenta a utilizar NO NR\NF
<getPdf> (Metadato) Indica si se obtiene el PDF de la factura. Sobreescribe el valor configurado en el conector. Los valores “no”, “falso”, “false”, y “0” (cero), sin distinción entre mayúsculas y minúsculas, indican que NO, cualquier otro valor se entiende como SI. NO NF
[campos_extra] Información adicional del concepto que deberá tenerse en cuenta en el PDF personalizado. El nombre de cada campo extra es personalizado y se indica entre corchetes. Ej [huesped], [transportista]. Requiere utilizar un PDF personalizado. NO NR\NF

Datos del Cliente

Campo Descripción Req. Función
id Número de cliente. Si este valor no es recibido, el sistema le asigna el siguiente número de cliente disponible. Si este valor es recibido el sistema lo busca y al encontrarlo actualiza al cliente. Si no lo encuentra entonces lo busca por el rfc y si tampoco lo encuentra lo da de alta en el sistema con el siguiente número disponible. NO NF
rfc RFC del cliente. Si no se encuentra el cliente por su id o si este último no se proporciona, el sistema busca el cliente por el RFC dado y actualiza sus datos o, lo inserta si no se encuentra registrado. La excepción a este comportamiento son el RFC de Público General (XAXX010101000) y el RFC de extranjeros (XEXX010101000); en estos casos especiales no se realiza la búsqueda por RFC, solo por id y, de no encontrarse con el id, siempre se insertan o actualizan los ids especiales -1 y -2 respectivamente. SI NF
nombre Nombre o Razón Social del Cliente. NO NF
calle Calle, avenida, boulevard, etc. de la dirección fiscal del cliente. NO NF
noExterior Número exterior de la dirección fiscal del cliente. NO NF
noInterior Número interior de la dirección fiscal del cliente. NO NF
colonia Colonica, fraccionamiento, etc. de la dirección fiscal del cliente. NO NF
municipio Municipio de la dirección fiscal del cliente. NO NF
estado Estado de la dirección fiscal del cliente. NO NF
pais Código ISO de dos letras del País de la dirección fiscal del cliente. (Si el cliente es nuevo, el valor por defecto es MX), ej.: US. NO NF
codigoPostal Código postal de la dirección fiscal del cliente. NO NF
telefono Número de teléfono del cliente. NO NF
correo Dirección de correo electrónico del cliente, en caso de indicarlo, a esta dirección se envía la factura. NO NF
enviar_factura Define si se envía o no automáticamente la factura al cliente. Si se omite completamente este campo, se toma en cuenta la configuración del la cuenta. Se recomienda como valores los textos SI ó NO, sin distinción de mayúsculas. Técnicamente, los valores “no”, “falso”, “false”, y “0” (cero), indican que NO, cualquier otro valor se interpreta como SI. NO NF

Conceptos

Campo Descripción Req. Función
noIdentificacion Código o número de identificación del producto. NO NR\NF
unidad Unidad de medida del producto o servicio, se recomienda utilizar los mismos que el SAT. SI NR\NF
cantidad Cantidad del producto o servicio a facturarse en la corrida. SI NR\NF
descripcion Descripción del producto o servicio. SI NR\NF
valorUnitario Precio del producto o servicio. SI NR\NF
importe Producto de multiplicar la cantidad por el precio unitario. Si no se indica se calcula automáticamente. NO NR\NF
impuesto Cantidad resultante de aplicar la tada de impuesto al resultado de la multiplicación de la cantidad con el valorUnitario. SI NR\NF
porcentaje_imp Porcentaje de impuesto IVA aplicado, ya sea 0 o 16. SI NR\NF
numero_pedimento Número de pedimento en caso de ser mercancía importada, obligatorio si se trata importación de primera mano. requerido si se indica fecha de pedimento o aduana. NO NR\NF
fecha_pedimento Fecha del pedimento si este se indica. Requerido si se indica un número de pedimento o aduana. NO NR\NF
nombre_aduana Nombre de la aduana donde se introdujo la mercancía importada. Requerido si se indica número o fecha de pedimento. NO NR\NF
descuento Descuento aplicado directamente al concepto. NO NR\NF
[campos_extra] Información adicional del concepto que deberá tenerse en cuenta en el PDF personalizado. El nombre de cada campo extra es personalizado y se indica entre corchetes. Ej: [color], [modelo]. NO NR\NF


Catálogo de Comprobantes

ID Tipo de Comprobante
0 Factura
1 Recibo de Honorarios
2 Recibo de Arrendamiento
3 Recibo de Pago
4 Recibo de Donativos
5 Nota de Cargo
6 Nota de Crédito
7 Nota de Devolución
8 Carta Porte

Catálogo de códigos de respuesta

Código Descripción
-1 Error en el contenido o la estructura de los datos.
1 Procesamiento correcto.
5 Error en el request recibido.
10 Error en la configuración (metadata), o cuenta enviada.
100 Error al procesar.
101 Error durante el sellado.
datos-soportados-servicio-conector.txt · Última modificación: 2016/01/05 17:15 (editor externo)