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:
409si el pedido está anulado o ya generó comprobantes / notas de venta vigentes.422si faltacustomer_id,currency_type_id,exchange_rate_sale,date_of_issue,totaloitems(cada ítem exigeitem_id,quantity> 0 eitem).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.