Saltar al contenido principal

Crear orden de venta

Cuando un cliente reserva productos para recogerlos o pagarlos más tarde, la orden de venta aparta la mercadería sin facturar. También sirve cuando el cliente aún decide cantidades y usted quiere dejar el pedido anotado para cerrarlo después. Al guardar la orden, los productos almacenables quedan reservados para ese cliente. Los pasos para crear una nueva orden de venta desde el punto de venta son los siguientes:

  1. Ir a "Punto de Venta" (P.D.V.).
  2. Seleccionar "Nueva Orden".
  3. Seleccionar los productos que solicitó el cliente.

Los campos que se pueden colocar en la orden de venta son:

a. Referencia: coloque una referencia breve para identificar la orden.

b. Cliente: seleccione un cliente existente o agregue uno nuevo.

c. Vendedor: empleado que realiza la venta.

d. Código de barras: escanee los códigos o escríbalos manualmente para agregar los productos a la orden.

e. Cantidad: use "+" y "-" para agregar o quitar unidades del mismo producto.

f. Sujeto a impuestos: seleccione si la orden se emitirá como factura o solo como recibo comprobante.

imagen1

https://app.zauru.com/pos/sale_orders/new

Agregue los productos o servicios y la cantidad; defina si la orden registra impuestos o es solo recibo, y presione "Guardar" para emitirla.

imagen2

https://app.zauru.com/pos/sale_orders/new

Al presionar "Guardar", la orden se genera automáticamente y los productos almacenables quedan reservados.

Después de crearla, todavía puede editarla para agregar o quitar productos, eliminarla o emitir la factura.

imagen3

https://app.zauru.com/pos/sale_orders

Listado de órdenes de venta​

Para ver las órdenes de venta pendientes:

  1. Ir a "P.D.V."
  2. Seleccionar "Órdenes".

Aparecerá un listado con las órdenes que cumplen estas condiciones:

  • No han sido emitidas como factura.
  • No están pagadas.
  • No están anuladas.
  • Pertenecen a la agencia del usuario.

Puede filtrar por:

a. Etiquetas: filtre por etiquetas asignadas.

Desde el listado puede:

a. Ver detalle: haga click sobre una orden para ver sus productos, precios y otros datos.

b. Editar: modifique la orden para agregar o quitar productos. Vea "Editar una orden de venta".

c. Emitir factura: convierta la orden en factura. Vea "Crear factura".

d. Imprimir: use las plantillas de impresión configuradas.

e. Anular: anule la orden si ya no es necesaria.

f. Cobrar: registre el cobro si la orden ya fue emitida como factura.

Editar una orden de venta​

Para modificar una orden que aún no ha sido emitida como factura:

  1. En el listado de órdenes, localice la orden.
  2. Seleccione el icono "Editar".
  3. Puede modificar los siguientes campos:

a. Referencia: actualice la referencia.

b. Cliente: cambie el cliente asociado.

c. Vendedor: cambie el vendedor.

d. Productos: agregue o quite productos; modifique cantidades y precios.

e. Sujeto a impuestos: cambie si genera factura o recibo.

f. Descuento: aplique un descuento global.

g. Etiquetas: asigne o modifique etiquetas.

  1. Presione "Guardar" para actualizar la orden.

Nota: Si la orden ya fue emitida como factura, no se puede editar.

Anular una orden de venta​

Para anular una orden:

  1. En el listado de órdenes, localice la orden.
  2. Presione "Anular".
  3. Confirme la anulación.

Importante: No se puede anular una orden con envíos en tránsito asociados. Al anularla, los productos reservados se devuelven al inventario.

Ya sabe crear, editar y anular una orden de venta. Cuando el cliente confirme la compra, conviértala en factura con un clic y registre el cobro, sin volver a escribir los datos.

API (llamadas desde sistemas externos)​

Solicitar items con existencias y precios y paquetes con existencias y precios en la bodega asignada al usuario​

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/pos/sale_orders/new.json

Esto devolverá un JSON similar a este:

{
  "items": [
    {
      "id": 5,
      "zid": 6,
      "active": true,
      "stockable": false,
      "sellable": true,
      "manufacturable": false,
      "purchasable": false,
      "code": "S31",
      "ean13": "",
      "name": "1 hora de Configurar Impresoras",
      "image": {
        "url": null,
        "thumbnail_fill": {
          "url": null
        }
      },
      "item_category_id": 7,
      "measurement_unit": "",
      "weight": null,
      "volume": null,
      "description": "1 Hora de configurar impresora",
      "reorder_point": null,
      "economic_order_quantity": null,
      "months_warranty": null,
      "entity_id": 2,
      "updater_id": 1,
      "created_at": "2014-05-12T17:13:50.569Z",
      "updated_at": "2018-05-15T14:35:24.650Z",
      "pays_vat": true,
      "tariff_rate": 0.0,
      "pdf": {
        "url": null,
        "thumbnail": {
          "url": null
        }
      },
      "product_type": 1,
      "payee_id": null,
      "average_cost": null,
      "fifo_cost": null,
      "lifo_cost": null,
      "extra_tax_1": 0.0,
      "extra_tax_2": 0.0,
      "quotable": true,
      "ecommerce": false,
      "msrp": null,
      "tax1_use_msrp": false,
      "tax2_use_msrp": false,
      "vendor_code": null,
      "stocks_only_integer": true,
      "brand_id": null,
      "color": "#cccccc",
      "item_country_code_id": null,
      "youtube_video_url": null,
      "inventory_account_id": null,
      "master_item_id": null,
      "gemma_q4f16_embedding": "[-0.09899902]",
      "force_as_good_for_document_external_storage_service": false,
      "extra_description": null,
      "tags": [],
      "item_category": {
        "id": 7,
        "name": "Soporte",
        "notes": "",
        "updater_id": 8,
        "entity_id": 2,
        "created_at": "2014-05-12T17:11:01.316Z",
        "updated_at": "2014-05-12T17:11:01.316Z",
        "items_count": 6,
        "bundles_count": 0,
        "item_super_category_id": null,
        "color": "#ff0000",
        "image": {
          "url": null,
          "thumbnail_fill": {
            "url": null
          }
        },
        "zid": 3
      }
    }
  ],
  "bundles": [
    {
      "id": 11,
      "active": true,
      "code": "base",
      "ean13": "",
      "name": "Modulo Base",
      "description": "",
      "entity_id": 2,
      "updater_id": 8,
      "created_at": "2014-11-05T22:58:16.287Z",
      "updated_at": "2014-11-05T22:58:16.287Z",
      "bundle_details_count": 4,
      "pays_vat": true,
      "image": {
        "url": null,
        "thumbnail_fill": {
          "url": null
        }
      },
      "item_category_id": 12,
      "quotable": true,
      "ecommerce": false,
      "sellable": true,
      "weight": null,
      "volume": null,
      "color": "#CCCCCC",
      "zid": 2,
      "measurement_unit": null,
      "purchasable": false,
      "force_as_service_for_document_external_storage_service": false,
      "category_bundle": false,
      "item_country_code_id": null,
      "youtube_video_url": null,
      "gemma_q4f16_embedding": "[-0.09899902]",
      "extra_description": null,
      "item_category": {
        "id": 12,
        "name": "cuotas mensuales",
        "notes": "super categoría",
        "updater_id": 1,
        "entity_id": 2,
        "created_at": "2010-04-14T05:28:45.000Z",
        "updated_at": "2020-06-10T21:10:07.675Z",
        "items_count": 113,
        "bundles_count": 1,
        "item_super_category_id": null,
        "color": "#ff0000",
        "image": {
          "url": null,
          "thumbnail_fill": {
            "url": null
          }
        },
        "zid": 1
      }
    }
  ],
  "item_stocks": {
    "344504": null
  },
  "bundle_stocks": {
    "2655": null
  },
  "item_prices": {
    "344504": 3050.0
  },
  "bundle_prices": {
    "2655": "229.0"
  }
}

La respuesta también incluye el objeto order, con los mismos campos de la orden que Ver orden de venta.

Los campos image2 a image5 repiten la estructura de image en cada producto o paquete.

Listar ordenes de venta (datatables)​

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X POST \
  -d '{
    "order": {
      "0": {
        "column": "3",
        "dir": "desc"
      }
    },
    "start": "0",
    "length": "40",
    "search": {
      "value": "",
      "regex": "false"
    }
  }' \
  https://app.zauru.com/pos/sale_orders/datatables.json

Esto devolverá un JSON similar a este:

{
  "draw": 0,
  "recordsTotal": 1,
  "recordsFiltered": 1,
  "data": [
    {
      "z": "<a href=\"/pos/sale_orders/16403492\">17297</a>",
      "i": "",
      "ref": "",
      "crea": "06 de ago a las 04:14 hrs",
      "tag": "",
      "cli": "LUIS CASTILLO",
      "itms": 1,
      "tot": "0.00",
      "due": "0.00",
      "r": "<a title=\"Detalles\" href=\"/pos/sale_orders/16403492\"><i class=\"fa fa-eye\"></i></a><a title=\"Editar\" href=\"/pos/sale_orders/16403492/edit\"><i class=\"fa fa-edit\"></i></a><a title=\"Anular\" data-confirm=\"¿Está seguro de destruirlo?\" href=\"/pos/sale_orders/16403492/void?destroy=true\"><i class=\"fa fa-trash-o\"></i></a>",
      "r2": "<a title=\"Emitir Factura Rápido\" href=\"/pos/invoices/1/issue_fast\"><i class=\"fa fa-bolt\"></i></a><a title=\"Emitir Factura\" href=\"/pos/invoices/1/edit\"><i class=\"fa fa-certificate\"></i></a>",
      "DT_RowId": "pos-order-16403492"
    }
  ]
}

Ver orden de venta​

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/pos/sale_orders/1.json

Esto devolverá un JSON similar a este:

{
  "id": 1,
  "zid": 1,
  "order_number": "ORD-456",
  "invoice_number": "SERIE A - 456",
  "reference": "prueba editada",
  "date": "2026-08-06",
  "subtotal": "750.0",
  "discount_id": null,
  "extra_discount": "0.0",
  "total": "750.0",
  "due": "686.0",
  "needs_delivery": false,
  "delivery_date": null,
  "delivery_address": null,
  "seller_id": 1,
  "creator_id": 2,
  "updater_id": 3,
  "taxable": true,
  "issuer_id": 2,
  "issued": true,
  "issued_at": "2010-05-31T18:39:45.000Z",
  "paid": false,
  "paid_at": null,
  "voider_id": 3,
  "voided": true,
  "voided_at": "2026-08-06T04:14:21.145Z",
  "entity_id": 2,
  "memo": "editado desde el API",
  "order_image": {
    "url": null,
    "standard": {
      "url": null
    }
  },
  "invoice_image": {
    "url": null,
    "standard": {
      "url": null
    }
  },
  "payee_id": 4,
  "payment_expected_at": "2026-08-06",
  "agency_id": 5,
  "payment_term_id": 6,
  "created_at": "2024-01-15T06:39:00.000Z",
  "updated_at": "2026-08-06T04:17:23.356Z",
  "invoice_details_count": 1,
  "shipper_id": 1,
  "pos": true,
  "order_pdf": {
    "url": null,
    "thumbnail": {
      "url": null
    }
  },
  "contract_id": null,
  "electronic_authorization_supporting_document": null,
  "electronic_tax_document": null,
  "crm_url": null,
  "zid_by_agency_and_creator": 1,
  "not_included_vat": null,
  "exchange_rate": 1.0,
  "excempt": false,
  "currency_id": 1,
  "resolution": null,
  "resolution_date": null,
  "authorized_serial": null,
  "foreign": false,
  "ecommerce_request_id": null,
  "external_image_url": null,
  "uuid": "26627e02-55af-4621-a359-77978aec0ad5",
  "id_number": null,
  "great_contributor": null,
  "sales_consolidate_id": null,
  "email": null,
  "resolution_notes": null,
  "client_identification_type_when_issuing_invoices": 0,
  "export": false,
  "export_references": null,
  "sv_ccf": false,
  "contingency": 0,
  "withheld_vat": null,
  "withheld_income_tax": null,
  "contingency_number": null,
  "cr_ticket": false,
  "mail_resent_at": "2026-08-06T04:13:55.700Z",
  "donation": false,
  "gift_card_1_id": null,
  "gift_card_1_id_number": null,
  "gift_card_1_discount": "0.0",
  "gift_card_2_id": null,
  "gift_card_2_id_number": null,
  "gift_card_2_discount": "0.0",
  "export_consignee_name": null,
  "export_consignee_address": null,
  "export_consignee_country": null,
  "export_reference": null,
  "export_electronic_tax_document": null,
  "export_declaration": null,
  "payee": {
    "id": 4,
    "zid": 7,
    "id_number": "",
    "active": false,
    "name": "Cliente Ejemplo, S.A.",
    "vendor": false,
    "buyer": true,
    "tin": "1234567-K",
    "reference": "",
    "address_line_1": "Ciudad",
    "address_line_2": "",
    "delivery_address": "utatlán 2",
    "currency_id": 1,
    "credit_limit": "1000.0",
    "payee_category_id": null,
    "web": "",
    "phone": "5555-0004",
    "email": "contacto@ejemplo.com",
    "contact": "Juan Carlos Paz (4391-3001)",
    "contact_phone": "",
    "contact_email": "",
    "contact2": "",
    "contact2_phone": "",
    "contact2_email": "",
    "notes": "",
    "entity_id": 2,
    "updater_id": 8,
    "created_at": "2010-05-27T17:26:03.000Z",
    "updated_at": "2024-03-19T00:40:38.280Z",
    "employee_id": null,
    "service_provider": true,
    "invoices_in_credit_limit": null,
    "payment_delay_in_credit_limit": false,
    "pdf": {
      "url": null,
      "thumbnail": {
        "url": null
      }
    },
    "image": {
      "url": null,
      "standard": {
        "url": null
      },
      "thumbnail": {
        "url": null
      },
      "pos": {
        "url": null
      }
    },
    "excempt": false,
    "small_taxpayer": false,
    "foreign": false,
    "latitude": null,
    "longitude": null,
    "great_contributor": null,
    "tax_withholding_agent": false,
    "subject_to_withholding_taxes": false,
    "personal_identification_number": "",
    "client_for_export": false,
    "payee_activity_id": null,
    "city_id": null,
    "taxpayer_registry": null,
    "district_id": null,
    "default_payment_term_id": null,
    "country_id": 9
  },
  "invoice_details": [
    {
      "id": 1,
      "bundle_id": null,
      "item_id": 10,
      "serial_id": null,
      "reference": "",
      "unit_price": "250.0",
      "unit_exchange_price": null,
      "quantity": "2.0",
      "price": "750.0",
      "invoice_id": 1,
      "created_at": "2010-05-31T18:39:45.000Z",
      "updated_at": "2026-08-06T04:14:25.611Z",
      "item_bundle_name": "servicio hosting",
      "item_bundle_description": "Servicio de hosting y mantenimiento de página web y correos electrónicos.",
      "lot_id": null,
      "discount_id": null,
      "extra_tax_1": "0.0",
      "extra_tax_2": "0.0",
      "average_cost": "0.0",
      "tag_id": null,
      "dynamic_bundle_id": null,
      "entity_id": 2,
      "gift_card_id": null,
      "gift_card_type_id": null,
      "item": {
        "zid": 11,
        "code": "O5",
        "ean13": null,
        "name": "servicio hosting",
        "item_category_id": null
      }
    }
  ],
  "entries": [
    {
      "id": 12,
      "zid": 13,
      "printable": false,
      "invoice": "",
      "id_number": null,
      "reference": "",
      "date": "2010-02-08",
      "income": true,
      "memo": "create invoice",
      "image": {
        "url": null,
        "standard": {
          "url": null
        }
      },
      "verified": false,
      "audited": false,
      "payee_id": 4,
      "entity_id": 2,
      "reconciliation_id": null,
      "updater_id": 2,
      "account_id": 14,
      "amount": "750.0",
      "created_at": "2010-05-31T18:39:45.000Z",
      "updated_at": "2010-05-31T18:39:45.000Z",
      "splits_count": 1,
      "invoice_date": null,
      "pdf": {
        "url": null,
        "thumbnail": {
          "url": null
        }
      },
      "contract_id": null,
      "verified_at": null,
      "audited_at": null,
      "conciliation_id": null,
      "split_conciliation_id": null,
      "endorsement_restriction": false,
      "exempt": false,
      "small_taxpayer": false,
      "external_image_url": null,
      "reception_id": null,
      "inventory_audit_id": null,
      "source_doc_type_id": 1,
      "monthly_entry_source_doc_type_id": null,
      "cost_center_id": null,
      "account": {
        "code": "",
        "name": "ventas viejas",
        "currency_id": 1
      },
      "splits": [
        {
          "id": 12,
          "entry_id": 12,
          "amount": "750.0",
          "account_id": 7,
          "exchange_amount": null,
          "created_at": "2010-05-31T18:39:45.000Z",
          "updated_at": "2010-05-31T18:39:45.000Z",
          "reference": null,
          "verified": false,
          "verified_at": null,
          "audited": false,
          "audited_at": null,
          "cost_center_id": null,
          "entity_id": 2,
          "account": {
            "code": "",
            "name": "cuentas por cobrar clientes extranjeros",
            "currency_id": 1
          }
        }
      ]
    }
  ],
  "payment_details": [
    {
      "id": 1,
      "invoice_id": 1,
      "payment_id": 1,
      "amount": "250.0",
      "created_at": "2010-05-31T18:42:58.000Z",
      "updated_at": "2010-05-31T18:42:58.000Z",
      "reference": null,
      "credit_note_id": null,
      "entity_id": 2,
      "contract_id": null,
      "contract_recurrence": 0,
      "payment": {
        "zid": 1,
        "reference": "referencia actualizada",
        "date": "2024-01-15",
        "agency_id": 5,
        "amount": "250.0"
      }
    }
  ],
  "submissions": []
}

Crear orden de venta​

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X POST \
  -d '{
    "invoice": {
      "reference": "prueba",
      "taxable": "1",
      "payment_term_id": "1",
      "payee_id": "1",
      "seller_id": "1",
      "invoice_details_attributes": {
        "0": {
          "item_id": "1",
          "quantity": "1",
          "unit_price": "650"
        }
      }
    }
  }' \
  https://app.zauru.com/pos/sale_orders.json

En caso de éxito, retorna un código HTTP 201 Created y la orden creada, con los mismos campos que Editar orden de venta.

Editar orden de venta​

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/pos/sale_orders/1/edit.json

Devuelve la orden con los mismos campos que Ver orden de venta, excepto payee, invoice_details, entries, payment_details y submissions.

Actualizar orden de venta​

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X PUT \
  -d '{
    "invoice": {
      "reference": "prueba editada",
      "invoice_details_attributes": {
        "0": {
          "id": "1",
          "quantity": "2"
        }
      }
    }
  }' \
  https://app.zauru.com/pos/sale_orders/1.json

Devuelve la orden actualizada, con el mismo JSON de Editar orden de venta.

Anular orden de venta​

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/pos/sale_orders/1/void.json

En caso de éxito, retorna un código HTTP 204 No Content (sin cuerpo). Si la orden no se puede anular (por ejemplo, por envíos en tránsito), devuelve un código HTTP 422.

Eliminar orden de venta​

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X DELETE \
  https://app.zauru.com/pos/sale_orders/1.json

En caso de exito, retorna un codigo HTTP 204 No Content (sin cuerpo).

Obtener categorías, items, paquetes, precios, existencias e imágenes​

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/pos/sale_orders/get_categories_items_bundles_prices_stocks_images.json

Esto devolverá un JSON similar a este:

{
  "items": [
    {
      "id": 1,
      "zid": 2,
      "active": true,
      "stockable": false,
      "code": "S31",
      "ean13": "",
      "name": "1 hora de Configurar Impresoras",
      "image": {
        "url": null,
        "thumbnail_fill": {
          "url": null
        }
      },
      "item_category_id": 3,
      "measurement_unit": "",
      "weight": null,
      "volume": null,
      "description": "1 Hora de configurar impresora",
      "updated_at": "2018-05-15T14:35:24.650Z",
      "pays_vat": true,
      "pdf": {
        "url": null,
        "thumbnail": {
          "url": null
        }
      },
      "product_type": 1,
      "payee_id": null,
      "extra_tax_1": 0.0,
      "extra_tax_2": 0.0,
      "stocks_only_integer": true,
      "brand_id": null,
      "color": "#cccccc",
      "item_country_code_id": null,
      "youtube_video_url": null,
      "inventory_account_id": null,
      "master_item_id": null,
      "gemma_q4f16_embedding": "[-0.09899902]",
      "force_as_good_for_document_external_storage_service": false,
      "extra_description": null,
      "tags": []
    }
  ],
  "item_categories_count": {
    "12": 105
  },
  "bundles": [
    {
      "id": 6,
      "active": true,
      "code": "base",
      "ean13": "",
      "name": "Modulo Base",
      "description": "",
      "updated_at": "2014-11-05T22:58:16.287Z",
      "bundle_details_count": 4,
      "pays_vat": true,
      "image": {
        "url": null,
        "thumbnail_fill": {
          "url": null
        }
      },
      "item_category_id": 7,
      "weight": null,
      "volume": null,
      "color": "#CCCCCC",
      "zid": 2,
      "measurement_unit": null,
      "purchasable": false,
      "force_as_service_for_document_external_storage_service": false,
      "category_bundle": false,
      "item_country_code_id": null,
      "youtube_video_url": null,
      "gemma_q4f16_embedding": "[-0.09899902]",
      "extra_description": null,
      "tags": []
    }
  ],
  "bundle_categories_count": {
    "12": 1
  },
  "categories": [
    {
      "id": 9,
      "name": "cuotas distribuidor",
      "notes": "super categoría",
      "updated_at": "2020-06-10T21:09:56.741Z",
      "items_count": 13,
      "bundles_count": 1,
      "item_super_category_id": null,
      "color": "#ff0000",
      "image": {
        "url": null,
        "thumbnail_fill": {
          "url": null
        }
      },
      "zid": 2
    }
  ],
  "super_categories": [],
  "item_super_categories_count": {
    "": 6
  },
  "gift_card_items_with_stock": {},
  "gift_card_types": [],
  "gift_card_types_count": 0,
  "gift_card_prices": {},
  "gift_card_stocks": {},
  "gift_card_flexible_prices": {},
  "count_all": 159,
  "item_stocks": {
    "344504": null
  },
  "bundle_stocks": {
    "2655": null
  },
  "item_prices": {
    "344504": 3050.0
  },
  "bundle_prices": {
    "2655": "229.0"
  },
  "flexible_items_prices": {
    "344504": true
  },
  "flexible_bundles_prices": {
    "2655": true
  },
  "brands_count": {
    "": 157
  },
  "brands": [],
  "brands_categories": {
    "": [
      12
    ]
  },
  "show_items_image": false,
  "double_width_button": false
}

¿Le fue útil esta guía?