Crear compra

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": "ARS",
  "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,
      "payment_term_days": null,
      "import_document_role": null,
      "import_source_purchase_id": null,
      "import_nationalization_status": null,
      "customs_dispatch_number": null,
      "warehouse_id": null,
      "products_received": false,
      "products_returned": false,
      "inventory_effect": "none",
      "update_product_variant_cost": true,
      "currency": "ARS",
      "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,
        "will_return_products": false,
        "will_decrease_direct_stock": false,
        "inventory_effect": "none",
        "warehouse_id": null,
        "product_line_count": 1,
        "total_quantity": 1,
        "purchase_order_ids": []
      },
      "accounting": {
        "will_create_journal_entry": true,
        "currency": "ARS",
        "exchange_rate": 1
      }
    }
  },
  "warnings": []
}

{
  "request_id": "req_purchase_1",
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Invalid request for creating purchases",
    "retryable": false,
    "type": "invalid_request_error",
    "details": []
  }
}

{
  "request_id": "req_purchase_1",
  "error": {
    "code": "AUTHENTICATION_REQUIRED",
    "message": "API key is required in the Authorization header",
    "retryable": false,
    "type": "invalid_request_error",
    "details": []
  }
}

{
  "request_id": "req_purchase_1",
  "error": {
    "code": "FORBIDDEN",
    "message": "Your API key does not have permission for this operation",
    "retryable": false,
    "type": "invalid_request_error",
    "details": []
  }
}

{
  "request_id": "req_purchase_1",
  "error": {
    "code": "IDEMPOTENCY_CONFLICT",
    "message": "The same Idempotency-Key was already used with a different purchase.",
    "retryable": false,
    "type": "invalid_request_error",
    "details": []
  }
}

{
  "request_id": "req_purchase_1",
  "error": {
    "type": "business_error",
    "code": "BUSINESS_REQUIREMENT_UNMET",
    "message": "A business requirement for the purchase is not met.",
    "retryable": false,
    "details": [
      {
        "field": "input.items",
        "code": "INVENTORY",
        "message": "Stock insuficiente. Stock actual: -34, cambio solicitado: 1"
      }
    ]
  }
}

{
  "request_id": "req_rate_limit_1",
  "error": {
    "type": "rate_limit_error",
    "code": "RATE_LIMITED",
    "message": "The organization request limit was reached. Try again later.",
    "retryable": true,
    "details": []
  }
}

{
  "request_id": "req_purchase_1",
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Could not process the purchase transaction",
    "retryable": false,
    "type": "invalid_request_error",
    "details": []
  }
}

{
  "request_id": "req_auth_capacity_1",
  "error": {
    "type": "api_error",
    "code": "INTERNAL_ERROR",
    "message": "La verificación de credenciales está ocupada. Reintentá más tarde.",
    "retryable": true,
    "details": []
  }
}

POST

api

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": "ARS",
  "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,
      "payment_term_days": null,
      "import_document_role": null,
      "import_source_purchase_id": null,
      "import_nationalization_status": null,
      "customs_dispatch_number": null,
      "warehouse_id": null,
      "products_received": false,
      "products_returned": false,
      "inventory_effect": "none",
      "update_product_variant_cost": true,
      "currency": "ARS",
      "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,
        "will_return_products": false,
        "will_decrease_direct_stock": false,
        "inventory_effect": "none",
        "warehouse_id": null,
        "product_line_count": 1,
        "total_quantity": 1,
        "purchase_order_ids": []
      },
      "accounting": {
        "will_create_journal_entry": true,
        "currency": "ARS",
        "exchange_rate": 1
      }
    }
  },
  "warnings": []
}

{
  "request_id": "req_purchase_1",
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Invalid request for creating purchases",
    "retryable": false,
    "type": "invalid_request_error",
    "details": []
  }
}

{
  "request_id": "req_purchase_1",
  "error": {
    "code": "AUTHENTICATION_REQUIRED",
    "message": "API key is required in the Authorization header",
    "retryable": false,
    "type": "invalid_request_error",
    "details": []
  }
}

{
  "request_id": "req_purchase_1",
  "error": {
    "code": "FORBIDDEN",
    "message": "Your API key does not have permission for this operation",
    "retryable": false,
    "type": "invalid_request_error",
    "details": []
  }
}

{
  "request_id": "req_purchase_1",
  "error": {
    "code": "IDEMPOTENCY_CONFLICT",
    "message": "The same Idempotency-Key was already used with a different purchase.",
    "retryable": false,
    "type": "invalid_request_error",
    "details": []
  }
}

{
  "request_id": "req_purchase_1",
  "error": {
    "type": "business_error",
    "code": "BUSINESS_REQUIREMENT_UNMET",
    "message": "A business requirement for the purchase is not met.",
    "retryable": false,
    "details": [
      {
        "field": "input.items",
        "code": "INVENTORY",
        "message": "Stock insuficiente. Stock actual: -34, cambio solicitado: 1"
      }
    ]
  }
}

{
  "request_id": "req_rate_limit_1",
  "error": {
    "type": "rate_limit_error",
    "code": "RATE_LIMITED",
    "message": "The organization request limit was reached. Try again later.",
    "retryable": true,
    "details": []
  }
}

{
  "request_id": "req_purchase_1",
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Could not process the purchase transaction",
    "retryable": false,
    "type": "invalid_request_error",
    "details": []
  }
}

{
  "request_id": "req_auth_capacity_1",
  "error": {
    "type": "api_error",
    "code": "INTERNAL_ERROR",
    "message": "La verificación de credenciales está ocupada. Reintentá más tarde.",
    "retryable": true,
    "details": []
  }
}

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: x >= 1

currency

enum<string>

required

Available options:

ARS,

USD

supplier_id

string<uuid>

import_document_role

enum<string> | null

Rol del comprobante dentro del flujo de importacion.

Available options:

commercial_invoice,

customs_dispatch,

customs_dispatch_reversal

import_source_purchase_id

string<uuid>

ID de la factura comercial asociada al despacho aduanero.

import_nationalization_status

enum<string> | null

Estado de nacionalizacion de la factura comercial de importacion.

Available options:

pending_nationalization,

partially_nationalized,

fully_nationalized

cost_target_purchase_id

string<uuid> | null

Compra recibida a cuyo costo promedio suma este comprobante sin productos. null lo quita.

customs_dispatch_number

string

Numero de despacho aduanero informado por el proveedor. Hasta 32 caracteres.

Required string length: 1 - 32

supplier_invoice_number

string

Numero de comprobante del proveedor. Hasta 120 caracteres.

Required string length: 1 - 120

invoice_date

string<date>

Fecha del comprobante en formato YYYY-MM-DD.

account_date

string<date>

Fecha contable de la compra en formato YYYY-MM-DD.

due_date

string<date>

Fecha de vencimiento en formato YYYY-MM-DD.

payment_term_id

enum<string> · null · null

Available options:

days_7,

days_15,

days_30,

days_45,

days_60,

days_90,

days_30_60,

days_30_60_90

payment_term_days

integer | null

Cantidad de días hasta el vencimiento. Usá 0 para Contado. Se prefiere sobre paymentTermId.

Required range: 0 <= x <= 365

vat_perception_amount

integer

Required range: x >= 0

national_tax_amount

integer

Required range: x >= 0

gross_income_tax_amount

integer

Required range: x >= 0

gross_income_tax_breakdown

object[]

Show child attributes

municipal_tax_amount

integer

Required range: x >= 0

internal_tax_amount

integer

Required range: x >= 0

other_tax_amount

integer

Required range: x >= 0

warehouse_id

string<uuid> | null

products_received

boolean

products_returned

boolean

If true, a supplier credit note returns product quantities from the selected warehouse. Requires warehouseId. Invalid on non-credit purchases.

update_product_variant_cost

boolean

items

object[]

Show child attributes

subtotal

integer

Required range: x >= 0

tax_amount

integer

Required range: x >= 0

total

integer

Required range: x >= 0

discount

integer

Required range: x >= 0

exempt_amount

integer

Required range: x >= 0

non_taxed_amount

integer

Required range: x >= 0

base_amount

integer

Required range: x >= 0

vat_breakdown

object[]

Show child attributes

manual_account_allocations

object

Show child attributes

notes

string

Maximum string length: 1000

exchange_rate

number

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

Show child attributes

warnings

object[]

required

Show child attributes

Documentación

SDK

Referencia API

Authorizations

Headers

Body

Response