Herramientas de usuario
datos-soportados-servicio-conector
Tabla de Contenidos
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 23:15 (editor externo)
Herramientas de la página
