Herramientas de usuario

Herramientas del sitio


datos-soportados-servicio-conector

Diferencias

Muestra las diferencias entre dos versiones de la página.

Enlace a la vista de comparación

datos-soportados-servicio-conector [2015/02/07 02:00]
[Conceptos]
datos-soportados-servicio-conector [2016/01/05 23:15]
Línea 1: Línea 1:
  
-===== 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 | 
-|  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)