GEgetjusto

Registrar compra de inventario

Changed on

Crea la misma compra contable que Vite con movementType=inventory. Calcula costos e impuestos, actualiza existencias y, si paidAt tiene valor, registra el pago contable. Una nota de crédito invierte cantidades y montos. No realiza cobros ni transferencias bancarias. Las compras se consultan también en GET /tabs/{storeId}/accounting-movements. Requiere autorización admin y un usuario conectado; un token de integración sin usuario responde userRequired. Se aplican los mismos permisos y validaciones del formulario de inventario.

post/admin/inventory/stores/{storeId}/purchases

Request

  • Base URL
    https://api.service.getjusto.com/v3
  • Auth
    none declared

Path parameters

storeIdstring required

ID del local autorizado, obtenido de GET /ecommerce/stores.

Request body

commentsstring nullable

Comentarios de la compra.

providerIdstring nullable

Proveedor de GET /admin/inventory/providers.

invoiceIdstring nullable required

Número de factura o identificador de compra; se valida la duplicidad por proveedor y local.

issueDatestring date-time nullable required

Fecha de emisión de la factura.

dueDatestring date-time nullable

Fecha de vencimiento.

paidAtstring date-time nullable

Fecha de pago. Al crear con este campo se registra también el pago contable de la compra.

paymentMethod'creditCard' | 'debitCard' | 'cash' | 'transfer' | 'check' | 'other' | 'null' nullable

Medio utilizado para el pago contable.

paymentDescriptionstring nullable

Descripción del pago registrado al crear, por ejemplo número de transferencia.

documentType'invoice' | 'creditNote' | 'supportDocument' required

Tipo de documento. Una nota de crédito invierte los montos y el movimiento de existencias.

accountingMovementCategoryIdstring nullable

Categoría contable de GET /admin/inventory/accounting-categories.

inventoryTaxDocumentIdsstring[] nullable

Órdenes aprobadas o guías que se facturan. Se obtienen de GET /admin/inventory/stores/{storeId}/purchase-documents y deben pertenecer al mismo local.

Example request

{
  "invoiceId": "FACT-123",
  "issueDate": "2026-10-30T12:00:00Z",
  "documentType": "invoice",
  "providerId": "ti-pro-ejemplo",
  "ingredients": [
    {
      "ingredientId": "ti-ing-ejemplo",
      "quantity": 2,
      "totalCost": 2380,
      "taxes": {
        "cl": {
          "taxTypes": [
            "iva_19"
          ],
          "totalAmount": 2380
        }
      }
    }
  ],
  "items": []
}

Response

The OpenAPI spec

successboolean

Example response

{
  "success": true
}

Changes