Registrar compra de inventario
curl --request POST \
--url https://api.service.getjusto.com/v3/admin/inventory/stores/{storeId}/purchases \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"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": []
}
'import requests
url = "https://api.service.getjusto.com/v3/admin/inventory/stores/{storeId}/purchases"
payload = {
"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": []
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
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: []
})
};
fetch('https://api.service.getjusto.com/v3/admin/inventory/stores/{storeId}/purchases', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.service.getjusto.com/v3/admin/inventory/stores/{storeId}/purchases",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'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' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.service.getjusto.com/v3/admin/inventory/stores/{storeId}/purchases"
payload := strings.NewReader("{\n \"invoiceId\": \"FACT-123\",\n \"issueDate\": \"2026-10-30T12:00:00Z\",\n \"documentType\": \"invoice\",\n \"providerId\": \"ti-pro-ejemplo\",\n \"ingredients\": [\n {\n \"ingredientId\": \"ti-ing-ejemplo\",\n \"quantity\": 2,\n \"totalCost\": 2380,\n \"taxes\": {\n \"cl\": {\n \"taxTypes\": [\n \"iva_19\"\n ],\n \"totalAmount\": 2380\n }\n }\n }\n ],\n \"items\": []\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.service.getjusto.com/v3/admin/inventory/stores/{storeId}/purchases")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"invoiceId\": \"FACT-123\",\n \"issueDate\": \"2026-10-30T12:00:00Z\",\n \"documentType\": \"invoice\",\n \"providerId\": \"ti-pro-ejemplo\",\n \"ingredients\": [\n {\n \"ingredientId\": \"ti-ing-ejemplo\",\n \"quantity\": 2,\n \"totalCost\": 2380,\n \"taxes\": {\n \"cl\": {\n \"taxTypes\": [\n \"iva_19\"\n ],\n \"totalAmount\": 2380\n }\n }\n }\n ],\n \"items\": []\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.service.getjusto.com/v3/admin/inventory/stores/{storeId}/purchases")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"invoiceId\": \"FACT-123\",\n \"issueDate\": \"2026-10-30T12:00:00Z\",\n \"documentType\": \"invoice\",\n \"providerId\": \"ti-pro-ejemplo\",\n \"ingredients\": [\n {\n \"ingredientId\": \"ti-ing-ejemplo\",\n \"quantity\": 2,\n \"totalCost\": 2380,\n \"taxes\": {\n \"cl\": {\n \"taxTypes\": [\n \"iva_19\"\n ],\n \"totalAmount\": 2380\n }\n }\n }\n ],\n \"items\": []\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"_id": "<string>",
"websiteId": "<string>",
"storeId": "<string>"
}
}{
"success": "false",
"error": {
"error": "error",
"message": "The request has an error"
}
}Compras
Registrar compra de inventario
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//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
Registrar compra de inventario
curl --request POST \
--url https://api.service.getjusto.com/v3/admin/inventory/stores/{storeId}/purchases \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"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": []
}
'import requests
url = "https://api.service.getjusto.com/v3/admin/inventory/stores/{storeId}/purchases"
payload = {
"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": []
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
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: []
})
};
fetch('https://api.service.getjusto.com/v3/admin/inventory/stores/{storeId}/purchases', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.service.getjusto.com/v3/admin/inventory/stores/{storeId}/purchases",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'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' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.service.getjusto.com/v3/admin/inventory/stores/{storeId}/purchases"
payload := strings.NewReader("{\n \"invoiceId\": \"FACT-123\",\n \"issueDate\": \"2026-10-30T12:00:00Z\",\n \"documentType\": \"invoice\",\n \"providerId\": \"ti-pro-ejemplo\",\n \"ingredients\": [\n {\n \"ingredientId\": \"ti-ing-ejemplo\",\n \"quantity\": 2,\n \"totalCost\": 2380,\n \"taxes\": {\n \"cl\": {\n \"taxTypes\": [\n \"iva_19\"\n ],\n \"totalAmount\": 2380\n }\n }\n }\n ],\n \"items\": []\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.service.getjusto.com/v3/admin/inventory/stores/{storeId}/purchases")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"invoiceId\": \"FACT-123\",\n \"issueDate\": \"2026-10-30T12:00:00Z\",\n \"documentType\": \"invoice\",\n \"providerId\": \"ti-pro-ejemplo\",\n \"ingredients\": [\n {\n \"ingredientId\": \"ti-ing-ejemplo\",\n \"quantity\": 2,\n \"totalCost\": 2380,\n \"taxes\": {\n \"cl\": {\n \"taxTypes\": [\n \"iva_19\"\n ],\n \"totalAmount\": 2380\n }\n }\n }\n ],\n \"items\": []\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.service.getjusto.com/v3/admin/inventory/stores/{storeId}/purchases")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"invoiceId\": \"FACT-123\",\n \"issueDate\": \"2026-10-30T12:00:00Z\",\n \"documentType\": \"invoice\",\n \"providerId\": \"ti-pro-ejemplo\",\n \"ingredients\": [\n {\n \"ingredientId\": \"ti-ing-ejemplo\",\n \"quantity\": 2,\n \"totalCost\": 2380,\n \"taxes\": {\n \"cl\": {\n \"taxTypes\": [\n \"iva_19\"\n ],\n \"totalAmount\": 2380\n }\n }\n }\n ],\n \"items\": []\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"_id": "<string>",
"websiteId": "<string>",
"storeId": "<string>"
}
}{
"success": "false",
"error": {
"error": "error",
"message": "The request has an error"
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
ID del local autorizado, obtenido de GET /ecommerce/stores.
Body
application/json
Número de factura o identificador de compra; se valida la duplicidad por proveedor y local.
Fecha de emisión de la factura.
Tipo de documento. Una nota de crédito invierte los montos y el movimiento de existencias.
Available options:
invoice, creditNote, supportDocument Lista completa de ingredientes comprados y sus costos e impuestos.
Show child attributes
Show child attributes
Comentarios de la compra.
Proveedor de GET /admin/inventory/providers.
Fecha de vencimiento.
Fecha de pago. Al crear con este campo se registra también el pago contable de la compra.
Medio utilizado para el pago contable.
Available options:
creditCard, debitCard, cash, transfer, check, other, null Descripción del pago registrado al crear, por ejemplo número de transferencia.
Categoría contable de GET /admin/inventory/accounting-categories.
Lista completa de ítems adicionales sin ingrediente; [] si no hay.
Show child attributes
Show child attributes
Costo del despacho. En una edición envía su valor actual, o null cuando la compra no tiene despacho.
Show child attributes
Show child attributes
Archivos previamente cargados, en el mismo formato que el formulario de Tabs.
Show child attributes
Show child attributes
Órdenes aprobadas o guías que se facturan. Se obtienen de GET /admin/inventory/stores/{storeId}/purchase-documents y deben pertenecer al mismo local.