Vendedores

Actualiza datos de vendedores. En caso de mandar nulos los valores en este endpoint no se modificarán en la base de datos. Si se quiere sobreescribir un campo con valores vacíos, se debe enviar un string vacío.

PUT/v1/vendedores

Request body

Campo	Tipo	Descripción
codigoVendedor	String(20)Required	Código del vendedor.
codigosEmpresas	Array(string(20))	Listado de códigos de empresas del vendedor.
telefono	String(20)	Teléfono del vendedor.
sucursal	String(20)	Sucursal del vendedor.
nombre	String(255)	Nombre del vendedor.
email	String(255)	Email del vendedor.

Response body

Campo	Tipo	Descripción
success	BooleanRequired	Indica si la operación se procesó con éxito.
message	String	Mensaje con el resultado. Si success es false, detalla el motivo del error.

Respuestas

Código	Significado
200	Actualización procesada. Los campos enviados en null no se modifican.
403	La API key enviada en `X-API-KEY` no es válida.
404	Falta el header `X-API-KEY` o la URL es incorrecta.
429	Se superó el límite de 30 requests por minuto.
500	Error interno del servidor. Reintentar más tarde.

cURL

curl --location --request PUT 'https://gateway.axum.com.ar/{tenant}/api/v1/vendedores' \
  --header 'X-API-KEY: {tenant-apikey}' \
  --header 'Content-Type: application/json' \
  --data '[ ... ]'

REQUEST BODY · EJEMPLO

[
  {
    "codigoVendedor": "001",
    "codigosEmpresas": [ "0001", "0002", "0003" ],
    "telefono": "35350122393",
    "sucursal": "0001",
    "nombre": "Juan Perez",
    "email": "juan@gmail.com"
  }
]

RESPONSE · 200 OK

{
  "success": true,
  "message": "Operación procesada correctamente"
}