LAlapyme
API

Crear cliente

Changed on

Crea un cliente para ventas, cuentas corrientes, etiquetas y reportes. Un DNI o CUIT que ya pertenece a otro cliente de la organización responde 409 CONFLICT.

post/api/v1/customers

Request

  • Base URL
    https://api.lapyme.com.ar
  • URL
    https://api.lapyme.com.ar/api/v1/customers
  • Auth
    HTTP bearer

Headers

Idempotency-Keystring required

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

X-Request-Idstring

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

Request body

default_account_idstring uuid nullable

Setting or clearing this field also requires treasury:write. Omit it to preserve the default.

codestring

Código visible del contacto; se genera si se omite

namestring required
company_namestring nullable
descriptionstring nullable
emailstring email nullable
phonestring nullable
tax_idstring nullable

Documento sin guiones, o "0" cuando tax_id_type es "Otro"

tax_id_type'CUIL/CUIT' | 'DNI' | 'Otro'
tax_category'registered_vat_taxpayer' | 'final_consumer' | 'monotributo_taxpayer' | 'vat_exempt' | 'vat_not_applicable' | 'foreign_customer'
arca_destination_countryinteger nullable
foreign_tax_idstring nullable
arca_country_tax_idstring nullable
countrystring nullable

Nombre del país. Obligatorio al crear un foreign_customer y al cambiar arca_destination_country; las actualizaciones sin cambio de destino conservan el nombre omitido.

provincestring nullable
citystring nullable
addressstring nullable
apartmentstring nullable
postal_codestring nullable
delivery_carrierstring nullable
delivery_addressstring nullable
assigned_salesperson_idstring uuid nullable
default_price_list_idstring uuid nullable
default_price_list_is_baseboolean

true selects explicit Base pricing and clears default_price_list_id. Omit both pricing fields on partial updates to preserve the preference. false restores legacy surface defaults when no named list is set.

payment_term_id'days_7' | 'days_15' | 'days_30' | 'days_45' | 'days_60' | 'days_90' | 'days_30_60' | 'days_30_60_90'
payment_term_daysinteger nullable

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

is_activeboolean

Response

Cliente creado exitosamente

request_idstring required

Changes

  • ed0d46e68fbeRevision changes
    • breaking

      for the header request parameter Idempotency-Key, the minLength was increased from 0 to 1

    • breaking

      for the header request parameter X-Request-Id, the minLength was increased from 0 to 1

    • breaking

      removed from the request property anyOf list

    • breaking

      removed from the request property anyOf list

    • breaking

      the request property's minLength was increased from 0 to 1

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property ///// became nullable for the status

    • breaking

      the response property ///// became nullable for the status

    • breaking

      the response property ///// became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • warning

      for the header request parameter Idempotency-Key, the maxLength was set to 255

    • warning

      for the header request parameter X-Request-Id, the maxLength was set to 255

    • warning

      the / request property's maxLength was set to 70

    • warning

      the / request property's maxLength was set to 10

    • warning

      the / request property's maxLength was set to 255

    • warning

      the / request property's maxLength was set to 70

    • warning

      the / request property's maxLength was set to 50

    • warning

      the / request property's maxLength was set to 2000

    • warning

      the / request property's maxLength was set to 255

    • warning

      the / request property's maxLength was set to 500

    • warning

      the / request property's maxLength was set to 100

    • warning

      the request property's maxLength was set to 200

    • warning

      the / request property's maxLength was set to 30

    • warning

      the / request property's maxLength was set to 8

    • warning

      the / request property's maxLength was set to 2

    • warning

      the / request property's maxLength was set to 32

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added to the request property anyOf list

    • info

      added to the request property anyOf list

    • info

      added the non-success response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added to the // response property anyOf list for the response status

    • info

      removed from the // response property anyOf list for the response status

    • info

      response property data/customer/address list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property data/customer/apartment list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property data/customer/city list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property data/customer/company_name list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property data/customer/contact_type list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property data/customer/country list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property data/customer/default_ganancias_regimen list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property data/customer/delivery_address list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property data/customer/delivery_carrier list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property data/customer/description list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property data/customer/email list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property data/customer/is_active list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property data/customer/payment_term_id list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property data/customer/phone list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property data/customer/postal_code list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property data/customer/province_id list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property data/customer/sales_overview/recent_sales/items/currency list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property data/customer/sales_overview/recent_sales/items/formatted_invoice_number list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property data/customer/sales_overview/recent_sales/items/original_sale_id list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property data/customer/tax_category list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property data/customer/tax_id list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property data/customer/tax_id_type list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status