Método PRODUCTOS

El método PRODUCTOS permite registrar y mantener el catálogo fiscal de productos que Quiero Mi Factura utilizará para emitir CFDI correctamente.

En muchas integraciones, las órdenes de venta no incluyen toda la información requerida por el SAT.
Por eso QMF necesita que cada producto cuente, como mínimo, con su Clave de Producto o Servicio SAT, Unidad y Clave Unidad.

Este catálogo puede cargarse por API, mediante Excel o completarse directamente en la interfaz web.

Información clave

Orden ≠ Producto. La orden trae la operación comercial; el catálogo de productos aporta la información fiscal de las mercancías o servicios, necesaria para timbrar correctamente.

¿Para qué sirve el método PRODUCTOS?

  • Relacionar productos vendidos con su información fiscal SAT.
  • Permitir que las órdenes puedan convertirse en CFDI válidos.
  • Enriquecer el catálogo para escenarios multicanal.
  • Apoyar reportes de inventario y consumo por concepto.
  • Agregar información avanzada como pedimento, aduana, IVA e IEPS.

Sin este catálogo correctamente cargado, una orden puede llegar a QMF pero no facturarse de forma correcta.

Formas de cargar productos en Quiero Mi Factura

1. Carga por integración API

El método PRODUCTOS permite registrar productos directamente desde un sistema externo mediante Web Services.

2. Carga mediante archivo Excel

QMF permite descargar un archivo de Excel, llenarlo con la información del catálogo y volver a subirlo. Esta opción es especialmente útil para cargas masivas o para completar productos pendientes.

3. Edición desde la interfaz web

Cuando existen productos con datos fiscales incompletos, QMF puede mostrarlos en la interfaz para que el usuario complete directamente los campos faltantes.

Campo llave de integración

El campo más importante en la relación entre la orden y el catálogo de productos es ASIN.

El Valor ASIN es el identificador con el que el marketplace, ecommerce o sistema que se esté vinculando, identifica de manera única al producto, y debe ser la misma clave que se envía al momento de enviar las órdenes usando el método RequestXMLCFDICompleto.

El valor enviado en la orden debe coincidir con el valor cargado en el catálogo de productos para que QMF sepa que se trata del mismo artículo.

Si el producto existe pero el identificador no coincide, la orden puede quedar sin los datos fiscales necesarios para facturar.

Campos mínimos requeridos para facturación

Para que QMF pueda timbrar correctamente, cada producto debe contar al menos con los siguientes campos:

Campo Obligatorio Descripción
ASIN Sí Identificador llave para relacionar la orden con el producto.
Clave SAT Sí Clave de producto o servicio del SAT.
Unidad Sí Texto descriptivo de la unidad.
Clave Unidad Sí Clave SAT de la unidad de medida.

Campos complementarios y avanzados

Además de los campos fiscales mínimos, QMF permite almacenar otros datos útiles para operación, inventario y trazabilidad:

Campo Uso
CodProducto Código interno del producto del vendedor.
SKU SKU interno para consolidar inventario y reportes.
NombreProducto Nombre descriptivo del producto.
Color Útil para variantes.
Referencia Permite ligar el producto con el RFC del vendedor.
Aduana Soporte para productos importados de primera mano.
NúmeroPedimento Dato obligatorio en ciertos casos de importación.
IVAT Tasa de IVA utilizada cuando está activa la opción “Impuestos por Excel”.
IEPST Tasa de IEPS del producto cuando aplica.

¿Por qué existen CodProducto y SKU?

En marketplaces, el mismo artículo puede llegar con identificadores distintos según el canal:

  • En Amazon, normalmente se usa un ASIN.
  • En Mercado Libre, el identificador puede comenzar con MLM.

Si el vendedor quiere consolidar ventas de inventario entre distintos marketplaces, necesita una referencia propia que le permita agrupar el mismo producto aunque cambie el identificador del canal.

Por eso QMF permite capturar CodProducto y SKU. Estos campos facilitan reportes de consumo de inventario y procesos posteriores de auditoría o integración.

Impuestos por Excel

Quiero Mi Factura tiene distintos comportamientos que son determinados a través de su configuración. Cuando está activa la funcionalidad Impuestos por Excel, QMF busca en el catálogo de productos las columnas correspondientes a impuestos para determinar cómo debe facturarse cada artículo.

  • IVAT: puede contener valores como 0, 8, 16 o Exento.
  • IEPST: puede contener la tasa numérica de IEPS aplicable al producto.

Esta opción no sustituye la necesidad de un catálogo bien mantenido; al contrario, depende directamente de él.

Todos los productos al igual que las demás cargas de información en Quiero Mi Factura, deben seguir las reglas de funcionamiento, en este caso, sobre todo las que tienen que ver con impuestos y decimales.

 

Aduana y número de pedimento

Cuando el vendedor es importador de primera mano, puede estar obligado a incluir datos de aduana y número de pedimento en la factura.

QMF ya soporta esta funcionalidad, aunque actualmente su operación es principalmente manual: el usuario debe actualizar el número de pedimento conforme se agota el lote correspondiente.

Si un cliente necesita esta funcionalidad, debe solicitar al equipo de soporte de QMF que la habilite.

Método PRODUCTOS (API)

El método PRODUCTOS permite registrar o actualizar productos en el catálogo de Quiero Mi Factura mediante Web Services.

Este método es utilizado cuando el catálogo de productos se administra desde un sistema externo como ERP, ecommerce o aplicación propia.

Campos del request

Campo Requerido Descripción
CodProducto Opcional Código interno del producto en el ERP.
NombreProducto Opcional Descripción del producto o servicio.
ClaveProdServ Requerido Clave SAT del producto o servicio.
Unidad Requerido Unidad de medida.
CodProductoMarketPlace Requerido Identificador del producto en el canal (ASIN / MLM).
ClaveUnidad Requerido Clave SAT de la unidad.
RFC Requerido RFC del emisor.

Ejemplo de request

<CodProducto>040094115501</CodProducto>
<NombreProducto>Hamilton Beach 11550 Generador</NombreProducto>
<ClaveProdServ>52141603</ClaveProdServ>
<Unidad>Pieza</Unidad>
<CodProductoMarketPlace>B00TSO3ET8AA</CodProductoMarketPlace>
<ClaveUnidad>H87</ClaveUnidad>
<RFC>ABC140702XYZ</RFC>

Endpoint

QA:
http://159.203.10.206/QA2/web_services/servidorMarket.php?wsdl

Respuesta del servicio

  • Estatus: ÉXITO o ERROR
  • NOTA1: Mensaje descriptivo del resultado

Si el registro es exitoso, el sistema responde con un mensaje equivalente a:
“Artículo actualizado”.

Importante:

El método PRODUCTOS no sustituye la lógica de negocio del integrador.
  • El integrador es responsable de enviar correctamente la información fiscal.
  • QMF no valida la lógica comercial del producto.
  • La consistencia entre orden y producto depende completamente del identificador enviado.

Flujo recomendado

  1. Cargar el catálogo inicial de productos por Excel o API.
  2. Validar que todos los productos tengan Clave SAT, Unidad y Clave Unidad.
  3. Corregir faltantes desde la interfaz web o cargando nuevamente el Excel.
  4. Confirmar que el identificador llave (ASIN) coincida con el enviado en las órdenes.
  5. Enviar las órdenes a QMF.
  6. Facturar solo cuando el catálogo fiscal ya esté completo.

Errores comunes

  • Enviar órdenes sin haber cargado previamente el catálogo de productos.
  • El ASIN del producto no coincide con el identificador enviado en la orden.
  • Falta Clave SAT, Unidad o Clave Unidad.
  • El usuario cargó el producto en Excel, pero no volvió a subir el archivo.
  • Se asume que el nombre del producto sustituye la información fiscal, pero no es así.
  • No se actualizó pedimento cuando el lote anterior ya se agotó.

Recomendaciones prácticas

  • Usa Excel para cargas iniciales masivas.
  • Usa API para altas automáticas de productos nuevos.
  • Mantén el ASIN como llave estable entre orden y catálogo.
  • Agrega CodProducto o SKU si el cliente necesita consolidar inventario multicanal.
  • Revisa periódicamente si QMF muestra productos con datos fiscales incompletos.

Explora la documentación

Navega por todas las secciones técnicas de Quiero Mi Factura para completar tu integración:

Scroll al inicio