La creación de facturas falla en los artículos configurables al utilizar la API de REST de Adobe Commerce

Última actualización: 22 de junio de 2026

La creación de facturas mediante la API de REST de Adobe Commerce falla en los productos configurables, donde el artículo no aparece en la factura y los errores de validación no entran en déclencheur. Para solucionar este problema, haga referencia al ID del artículo del producto configurable (principal) en lugar del producto simple (secundario) en la solicitud de factura.

Descripción description

Entorno

Adobe Commerce

Problema/Síntomas

Las facturas creadas mediante la API no incluyen productos configurables.
No aparece ningún mensaje de error cuando solo se utilizan ID de elementos secundarios (simples).
Incluyendo los Id. de artículo principal y secundario con la cantidad cero para las devoluciones principales La factura no se puede crear sin productos.
Productos simples facturados correctamente.

Resolución resolution

Para solucionar este problema, siga estos pasos:

Identifique el id. de artículo del producto configurable (principal) del pedido consultando la tabla sales_order_item.

code language-none

code language-none
`select item_id, sku, product_type from sales_order_item; 208 simple_skuA configurable 211 simple_skuA simple 214 simple_skuB configurable 217 simple_skuB simple 220 simple_skuC simple 223 simple_skuD simple`

select item_id, sku, product_type from sales_order_item;

208  simple_skuA    configurable
211  simple_skuA    simple
214  simple_skuB    configurable
217  simple_skuB    simple
220  simple_skuC    simple
223  simple_skuD    simple

Cree la factura a través de la API de REST incluyendo solo el ID de artículo del producto principal configurable en la carga útil de la solicitud.

Nota: no incluya identificadores de producto secundarios (simples) ni establezca la cantidad en cero para ningún artículo.

Ejecute la solicitud de creación de factura utilizando la siguiente estructura de carga útil:

code language-none

code language-none
`curl -X POST \ -H "Content-Type: application/json" \ -H "Authorization: Bearer <token>" \ https://<store_url>/rest/V1/order/<order_id>/invoice { "items": [ { "order_item_id": 208, "qty": 1 }, { "order_item_id": 220, "qty": 1 }, { "order_item_id": 223, "qty": 1 } ] }`

curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <token>" \
https://<store_url>/rest/V1/order/<order_id>/invoice

{
  "items": [
    {
      "order_item_id": 208,
      "qty": 1
    },
    {
      "order_item_id": 220,
      "qty": 1
    },
    {
      "order_item_id": 223,
      "qty": 1
    }
  ]
}

Compruebe que la factura creada incluye artículos de línea para todos los productos configurables deseados.

Nota

Si existen varias variaciones de un producto configurable dentro de un pedido, utilice cada ID de artículo principal correspondiente a esas variaciones al crear facturas.

select item_id, sku, product_type from sales_order_item;
226  simple_skuA   configurable
229  simple_skuA         simple
232  simple_skuB   configurable
235  simple_skuB         simple

En este ejemplo, la carga para la variante B de factura del SKU simple_skuB utiliza el ID de artículo principal 232.

Lectura relacionada

recommendation-more-help

experience-cloud-kcs-help-kbarticles