Saltar al contenido
Facturador

Editar pedido

PUT /api/order-notes/{order_note_id}

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Reemplaza la cabecera y los ítems del pedido (envía el pedido completo). Acepta PUT o PATCH. Para conservar una línea, envía su id (el de Ver pedido → items[].id); si cambia producto, cantidad, almacén o presentación, la línea se reemplaza y el stock se ajusta. Las líneas que no envíes se eliminan y devuelven su stock. No cambian número, usuario ni estado.

Quién puede usarlo: cualquier usuario autenticado. Un administrador accede a todos los registros; un vendedor solo a los que registró él (o en los que figura como vendedor). Si el registro existe pero es de otro vendedor responde 403.

Campo Tipo Obligatorio Descripción / valores permitidos
customer_id integer Sí customer_id es el id de un cliente ya registrado (persona de tipo cliente).
establishment_id integer Sí al crear Establecimiento del pedido.
seller_id integer No Vendedor asignado. Si el usuario autenticado es vendedor, siempre se usa él mismo.
date_of_issue date Sí YYYY-MM-DD.
time_of_issue string No HH:MM:SS.
date_of_due date No Vencimiento.
delivery_date date No Fecha de entrega.
currency_type_id string Sí PEN o USD.
exchange_rate_sale numeric Sí Tipo de cambio, mínimo 0.01 (usa 1 en soles).
payment_method_type_id string No Forma de pago prevista.
total_* / subtotal / total numeric Sí Totales de cabecera: total_taxed (gravado), total_exonerated, total_unaffected, total_free, total_igv, total_taxes, total_value (sin IGV), subtotal y total (con IGV). Deben cuadrar con la suma de las líneas: la plataforma no recalcula los totales que envías.
items array Sí Líneas (mín. 1) con warehouse_id del que se reserva el stock. Al editar, incluye id en las líneas que se conservan.
shipping_address string No Dirección de entrega.
observation string No Observación.
additional_data array No Datos adicionales [{title, description}] (ambos obligatorios en cada elemento).
custom_fields_data array No Campos personalizados.

Línea (items[]):

Campo Tipo Obligatorio Descripción / valores permitidos
item_id integer Sí Id del producto.
item object Sí Copia del producto tal como se guardará en el documento (al menos id, description, unit_type_id, internal_id, is_set, presentation). Se obtiene de los endpoints de productos de la API.
quantity numeric Sí Cantidad (> 0).
unit_value numeric Sí Valor unitario sin IGV.
unit_price numeric Sí Precio unitario con IGV.
affectation_igv_type_id string Sí Afectación IGV (catálogo SUNAT 07): 10 gravado, 20 exonerado, 30 inafecto.
price_type_id string Sí 01 precio unitario (incluye IGV), 02 valor referencial (gratuito).
percentage_igv numeric Sí Porcentaje de IGV (18, o 10 si aplica la Ley 31556).
total_base_igv / total_igv / total_taxes / total_value / total numeric Sí Totales de la línea: base imponible, IGV, impuestos, valor (sin IGV) y total (con IGV).
warehouse_id integer No Almacén del que sale el stock (por defecto el del establecimiento).
total_discount / total_charge / charges / discounts / attributes varios No Descuentos, cargos y atributos de la línea (usa 0 y [] si no aplica).
system_isc_type_id / total_base_isc / percentage_isc / total_isc / total_plastic_bag_taxes varios No ISC e ICBPER (usa null/0 si no aplica).

Errores:

  • 409 si el pedido está anulado o ya generó comprobantes / notas de venta vigentes.
  • 422 si falta customer_id, currency_type_id, exchange_rate_sale, date_of_issue, total o items (cada ítem exige item_id, quantity > 0 e item).
  • 403; 404.

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
order_note_id ruta sí 1

Cuerpo

Content-Type: application/json

{
  "customer_id": 1,
  "establishment_id": 1,
  "seller_id": 5,
  "date_of_issue": "2026-11-07",
  "time_of_issue": "16:00:00",
  "date_of_due": "2026-11-07",
  "delivery_date": "2026-11-10",
  "currency_type_id": "PEN",
  "exchange_rate_sale": 1,
  "payment_method_type_id": "01",
  "total_prepayment": 0,
  "total_charge": 0,
  "total_discount": 0,
  "total_exportation": 0,
  "total_free": 0,
  "total_taxed": 30.0,
  "total_unaffected": 0,
  "total_exonerated": 0,
  "total_igv": 5.4,
  "total_igv_free": 0,
  "total_base_isc": 0,
  "total_isc": 0,
  "total_base_other_taxes": 0,
  "total_other_taxes": 0,
  "total_taxes": 5.4,
  "total_value": 30.0,
  "subtotal": 35.4,
  "total": 35.4,
  "items": [
    {
      "item_id": 120,
      "item": {
        "id": 120,
        "item_id": 120,
        "internal_id": "P0001",
        "description": "GASEOSA 500ML",
        "unit_type_id": "NIU",
        "currency_type_id": "PEN",
        "sale_unit_price": 3.5,
        "purchase_unit_price": 2.2,
        "sale_affectation_igv_type_id": "10",
        "purchase_affectation_igv_type_id": "10",
        "is_set": false,
        "has_igv": true,
        "presentation": null
      },
      "currency_type_id": "PEN",
      "quantity": 3,
      "unit_value": 10.0,
      "affectation_igv_type_id": "10",
      "total_base_igv": 30.0,
      "percentage_igv": 18,
      "total_igv": 5.4,
      "system_isc_type_id": null,
      "total_base_isc": 0,
      "percentage_isc": 0,
      "total_isc": 0,
      "total_base_other_taxes": 0,
      "percentage_other_taxes": 0,
      "total_other_taxes": 0,
      "total_plastic_bag_taxes": 0,
      "total_taxes": 5.4,
      "price_type_id": "01",
      "unit_price": 11.8,
      "total_value": 30.0,
      "total_discount": 0,
      "total_charge": 0,
      "total": 35.4,
      "attributes": [],
      "charges": [],
      "discounts": [],
      "warehouse_id": 1,
      "id": 410
    }
  ],
  "shipping_address": "AV. LOS PINOS 789, SURCO",
  "observation": "Entregar por la tarde",
  "additional_data": [
    {
      "title": "Referencia",
      "description": "Frente al parque"
    }
  ],
  "charges": [],
  "discounts": [],
  "prepayments": [],
  "guides": [],
  "related": [],
  "legends": []
}

Respuestas

200 — Editado

{
  "success": true,
  "data": {
    "id": 58,
    "external_id": "f6a7b8c9-d0e1-4f2a-b3c4-d5e6f7a8b9c0",
    "number_full": "PD-58",
    "date_of_issue": "2026-11-07",
    "time_of_issue": "16:00:00",
    "date_of_due": "2026-11-07",
    "delivery_date": "2026-11-10",
    "state_type_id": "01",
    "state_type_description": "Registrado",
    "customer_id": 1,
    "customer": {
      "name": "CLIENTES VARIOS",
      "number": "00000000",
      "identity_document_type_id": "0"
    },
    "currency_type_id": "PEN",
    "total": 35.4,
    "user_id": 5,
    "seller_id": 5,
    "establishment_id": 1,
    "observation": "Entregar por la tarde",
    "user_name": "JUAN PEREZ",
    "seller_name": "JUAN PEREZ",
    "items": [
      {
        "id": 410,
        "item_id": 120,
        "item": {
          "id": 120,
          "item_id": 120,
          "internal_id": "P0001",
          "description": "GASEOSA 500ML",
          "unit_type_id": "NIU",
          "currency_type_id": "PEN",
          "sale_unit_price": 3.5,
          "purchase_unit_price": 2.2,
          "sale_affectation_igv_type_id": "10",
          "purchase_affectation_igv_type_id": "10",
          "is_set": false,
          "has_igv": true,
          "presentation": null
        },
        "warehouse_id": 1,
        "quantity": 3.0,
        "unit_price": 11.8,
        "total": 35.4
      }
    ]
  },
  "message": "Pedido actualizado"
}

422 — Sin ítems

{
  "success": false,
  "message": {
    "items": [
      "El campo items es obligatorio."
    ],
    "total": [
      "El campo total es obligatorio."
    ]
  }
}

409 — Ya facturado

{
  "success": false,
  "message": "El pedido ya generó comprobantes o notas de venta: no se puede editar."
}

Pruébalo

Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.