Skip to main content
POST
/
api
/
v1
/
purchases
curl --request POST \
  --url https://api.lapyme.com.ar/api/v1/purchases \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "supplier_id": "afafcbec-9d94-4174-8d5c-ec8d72780947",
  "voucher_type": 1,
  "supplier_invoice_number": "0001-00000001",
  "invoice_date": "2026-03-10",
  "currency": "PES",
  "exchange_rate": 1,
  "products_received": false,
  "update_product_variant_cost": true,
  "items": [
    {
      "product_id": "9c692e8b-0f9a-4f7c-8b99-061a2eb188ae",
      "quantity": 1,
      "unit_cost": 8250,
      "tax_rate_id": 5
    }
  ]
}
'
{
  "request_id": "req_purchase_commit_1",
  "data": {
    "purchase_id": "cf19b3ae-4c08-48be-b9d7-e6f2f5baf609",
    "receipt_created": false,
    "idempotent_replay": false,
    "normalized_purchase": {
      "supplier_id": "afafcbec-9d94-4174-8d5c-ec8d72780947",
      "voucher_type": 1,
      "supplier_invoice_number": "0001-00000001",
      "invoice_date": "2026-03-10",
      "account_date": null,
      "due_date": null,
      "payment_term_id": null,
      "import_document_role": null,
      "import_source_purchase_id": null,
      "import_nationalization_status": null,
      "customs_dispatch_number": null,
      "warehouse_id": null,
      "products_received": false,
      "update_product_variant_cost": true,
      "currency": "PES",
      "exchange_rate": 1,
      "subtotal": 8250,
      "tax_amount": 1733,
      "total": 9983,
      "discount": 0,
      "exempt_amount": 0,
      "non_taxed_amount": null,
      "base_amount": null,
      "vat_perception_amount": null,
      "national_tax_amount": null,
      "gross_income_tax_amount": null,
      "municipal_tax_amount": null,
      "internal_tax_amount": null,
      "other_tax_amount": null,
      "notes": null,
      "pdf_path": null,
      "items": []
    },
    "projected_effects": {
      "inventory": {
        "will_receive_products": false,
        "will_create_receipt": false,
        "will_increase_direct_stock": false,
        "warehouse_id": null,
        "product_line_count": 1,
        "total_quantity": 1,
        "purchase_order_ids": []
      },
      "accounting": {
        "will_create_journal_entry": true,
        "currency": "PES",
        "exchange_rate": 1
      }
    }
  },
  "warnings": []
}

Documentation Index

Fetch the complete documentation index at: https://docs.lapyme.com.ar/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Incluí tu API key en el header Authorization con el prefijo Bearer.

Headers

​
Idempotency-Key
string
required

Clave única para evitar duplicados al reintentar la misma creación de compra.

Required string length: 1 - 255
​
X-Request-Id
string

ID opcional de la solicitud para trazabilidad. Si se omite, el servidor genera uno.

Required string length: 1 - 255

Body

application/json
​
voucher_type
integer
required
Required range: 1 <= x <= 9007199254740991
​
currency
enum<string>
required
Available options:
PES,
DOL
​
supplier_id
string<uuid>
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
​
import_document_role
enum<string> | null
Available options:
commercial_invoice,
customs_dispatch,
customs_dispatch_reversal
​
import_source_purchase_id
string<uuid>
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
​
import_nationalization_status
enum<string> | null
Available options:
pending_nationalization,
partially_nationalized,
fully_nationalized
​
customs_dispatch_number
string
Required string length: 1 - 32
​
supplier_invoice_number
string
Required string length: 1 - 120
​
invoice_date
string<date>
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
​
account_date
string<date>
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
​
due_date
string<date>
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
​
payment_term_id
enum<string> | null
Available options:
days_7,
days_15,
days_30,
days_45,
days_60,
days_90,
days_30_60,
days_30_60_90
​
vat_perception_amount
integer
Required range: 0 <= x <= 9007199254740991
​
national_tax_amount
integer
Required range: 0 <= x <= 9007199254740991
​
gross_income_tax_amount
integer
Required range: 0 <= x <= 9007199254740991
​
gross_income_tax_breakdown
object[]
​
municipal_tax_amount
integer
Required range: 0 <= x <= 9007199254740991
​
internal_tax_amount
integer
Required range: 0 <= x <= 9007199254740991
​
other_tax_amount
integer
Required range: 0 <= x <= 9007199254740991
​
warehouse_id
string<uuid> | null
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
​
products_received
boolean
​
update_product_variant_cost
boolean
​
items
object[]
​
subtotal
integer
Required range: 0 <= x <= 9007199254740991
​
tax_amount
integer
Required range: 0 <= x <= 9007199254740991
​
total
integer
Required range: 0 <= x <= 9007199254740991
​
discount
integer
Required range: 0 <= x <= 9007199254740991
​
exempt_amount
integer
Required range: 0 <= x <= 9007199254740991
​
non_taxed_amount
integer
Required range: 0 <= x <= 9007199254740991
​
base_amount
integer
Required range: 0 <= x <= 9007199254740991
​
vat_breakdown
object[]
​
notes
string
Maximum string length: 1000
​
exchange_rate
number
Required range: x > 0
​
pdf_path
string
Required string length: 1 - 2000
​
vat_category
enum<string> | null
Available options:
goods,
fixed_assets,
leases,
services
​
status
enum<string>
Available options:
draft,
confirmed

Response

Compra creada exitosamente

​
request_id
string
required
​
data
object
required
​
warnings
object[]
required