===== 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 | | | (Metadato) Nombre de la cuenta a utilizar. | NO | NR\NF | | | (Metadato) Usuario de la cuenta a utilizar. | NO | NR\NF | | | (Metadato) Contraseña del usuario de la cuenta a utilizar| NO | NR\NF | | | (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. |