MENU navbar-image

Introduction

This documentation aims to provide all the information you need to work with our API.

<aside>As you scroll, you'll see code examples for working with the API in different programming languages in the dark area to the right (or as part of the content on mobile).
You can switch the language used with the tabs at the top right (or from the nav menu at the top left on mobile).</aside>

Authenticating requests

To authenticate requests, include an Authorization header with the value "Bearer <token>".

All authenticated endpoints are marked with a requires authentication badge in the documentation below.

You can retrieve your token by visiting your dashboard and clicking Generate API token.

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/sanctum/csrf-cookie" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/sanctum/csrf-cookie"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/sanctum/csrf-cookie could not be found."
}
 

POST api/actualizarestadopago

Example request:
curl --request POST \
    "https://agentes-vendor-back.puntossmart.com/api/actualizarestadopago" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/actualizarestadopago"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());

Request      

POST api/actualizarestadopago

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

GET api/infopagos

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/infopagos" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/infopagos"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/infopagos could not be found."
}
 

Request      

GET api/infopagos

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Pagos vendor Este sirve para ver los pagos de vendor

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/pagosvendorall" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/pagosvendorall"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/pagosvendorall could not be found."
}
 

Request      

GET api/pagosvendorall

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

GET api/obtenermontospago

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/obtenermontospago" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/obtenermontospago"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/obtenermontospago could not be found."
}
 

Request      

GET api/obtenermontospago

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

PUT api/actualizarmontospago

Example request:
curl --request PUT \
    "https://agentes-vendor-back.puntossmart.com/api/actualizarmontospago" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/actualizarmontospago"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "PUT",
    headers,
}).then(response => response.json());

Request      

PUT api/actualizarmontospago

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

GET api/pagosvendedorall

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/pagosvendedorall" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/pagosvendedorall"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/pagosvendedorall could not be found."
}
 

Request      

GET api/pagosvendedorall

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

POST api/pagosvendedor/{id_pago_vendor}

Example request:
curl --request POST \
    "https://agentes-vendor-back.puntossmart.com/api/pagosvendedor/consequatur" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/pagosvendedor/consequatur"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());

Request      

POST api/pagosvendedor/{id_pago_vendor}

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id_pago_vendor   string   

Example: consequatur

GET api/vouchers/{id}

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/vouchers/consequatur" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/vouchers/consequatur"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/vouchers/consequatur could not be found."
}
 

Request      

GET api/vouchers/{id}

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   string   

The ID of the voucher. Example: consequatur

POST api/enviarcomprobantepagovendor/{id}

Example request:
curl --request POST \
    "https://agentes-vendor-back.puntossmart.com/api/enviarcomprobantepagovendor/consequatur" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/enviarcomprobantepagovendor/consequatur"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());

Request      

POST api/enviarcomprobantepagovendor/{id}

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   string   

The ID of the enviarcomprobantepagovendor. Example: consequatur

Listar ubicaciones recientes por vendedor o global (según rol)

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/vendedores/locations" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/vendedores/locations"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/vendedores/locations could not be found."
}
 

Request      

GET api/vendedores/locations

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Última ubicación por cada vendedor del vendor (o para el vendedor actual)

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/vendedores/locations/latest" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/vendedores/locations/latest"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/vendedores/locations/latest could not be found."
}
 

Request      

GET api/vendedores/locations/latest

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Crear punto de ubicación (enviado por app móvil)

Example request:
curl --request POST \
    "https://agentes-vendor-back.puntossmart.com/api/vendedores/locations" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/vendedores/locations"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());

Request      

POST api/vendedores/locations

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

GET api/route-plans

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/route-plans" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/route-plans"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/route-plans could not be found."
}
 

Request      

GET api/route-plans

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

GET api/route-plans/{routePlan_id}

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/route-plans/consequatur" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/route-plans/consequatur"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/route-plans/consequatur could not be found."
}
 

Request      

GET api/route-plans/{routePlan_id}

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

routePlan_id   string   

The ID of the routePlan. Example: consequatur

POST api/route-plans

Example request:
curl --request POST \
    "https://agentes-vendor-back.puntossmart.com/api/route-plans" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"id_vendedor\": \"66529e01-d113-3473-8d6f-9e11e09332ea\",
    \"id_vendor\": \"fa010f60-df29-3f05-8bc7-bed48f550d13\",
    \"name\": \"opfuudtdsufvyvddqamni\",
    \"scheduled_date\": \"2025-09-20T17:07:35\",
    \"status\": \"scheduled\",
    \"profile\": \"walking\",
    \"stops\": [
        {
            \"label\": \"ihfqcoynlazghdtqtqxba\",
            \"latitude\": -90,
            \"longitude\": -179,
            \"sequence\": 5,
            \"type\": \"user_smart\",
            \"external_id\": \"670c8792-d451-3fdc-8fe0-37825f7257e2\"
        }
    ]
}"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/route-plans"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "id_vendedor": "66529e01-d113-3473-8d6f-9e11e09332ea",
    "id_vendor": "fa010f60-df29-3f05-8bc7-bed48f550d13",
    "name": "opfuudtdsufvyvddqamni",
    "scheduled_date": "2025-09-20T17:07:35",
    "status": "scheduled",
    "profile": "walking",
    "stops": [
        {
            "label": "ihfqcoynlazghdtqtqxba",
            "latitude": -90,
            "longitude": -179,
            "sequence": 5,
            "type": "user_smart",
            "external_id": "670c8792-d451-3fdc-8fe0-37825f7257e2"
        }
    ]
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

POST api/route-plans

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Body Parameters

id_vendedor   string  optional  

Must be a valid UUID. The id of an existing record in the vendedores table. Example: 66529e01-d113-3473-8d6f-9e11e09332ea

id_vendor   string  optional  

Must be a valid UUID. The id of an existing record in the vendors table. Example: fa010f60-df29-3f05-8bc7-bed48f550d13

name   string  optional  

Must not be greater than 255 characters. Example: opfuudtdsufvyvddqamni

scheduled_date   string  optional  

Must be a valid date. Example: 2025-09-20T17:07:35

status   string  optional  

Example: scheduled

Must be one of:
  • draft
  • scheduled
  • in_progress
  • completed
  • cancelled
profile   string  optional  

Example: walking

Must be one of:
  • driving
  • walking
stops   object[]  optional  
label   string  optional  

Must not be greater than 255 characters. Example: ihfqcoynlazghdtqtqxba

latitude   number   

Must be between -90 and 90. Example: -90

longitude   number   

Must be between -180 and 180. Example: -179

sequence   integer  optional  

Must be at least 0. Example: 5

type   string  optional  

Example: user_smart

Must be one of:
  • company
  • user_smart
  • custom
external_id   string  optional  

Must be a valid UUID. Example: 670c8792-d451-3fdc-8fe0-37825f7257e2

PUT api/route-plans/{routePlan_id}/status

Example request:
curl --request PUT \
    "https://agentes-vendor-back.puntossmart.com/api/route-plans/consequatur/status" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"status\": \"in_progress\"
}"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/route-plans/consequatur/status"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "status": "in_progress"
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

PUT api/route-plans/{routePlan_id}/status

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

routePlan_id   string   

The ID of the routePlan. Example: consequatur

Body Parameters

status   string   

Example: in_progress

Must be one of:
  • draft
  • scheduled
  • in_progress
  • completed
  • cancelled

DELETE api/route-plans/{routePlan_id}

Example request:
curl --request DELETE \
    "https://agentes-vendor-back.puntossmart.com/api/route-plans/consequatur" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/route-plans/consequatur"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

Request      

DELETE api/route-plans/{routePlan_id}

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

routePlan_id   string   

The ID of the routePlan. Example: consequatur

PUT api/route-stops/{routeStop_id}

Example request:
curl --request PUT \
    "https://agentes-vendor-back.puntossmart.com/api/route-stops/consequatur" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"label\": \"vmqeopfuudtdsufvyvddq\",
    \"sequence\": 1,
    \"status\": \"skipped\",
    \"notes\": \"mniihfqcoynlazghdtqtq\",
    \"visited_at\": \"2025-09-20T17:07:35\",
    \"retry_at\": \"2025-09-20T17:07:35\",
    \"outcome\": \"not_interested\"
}"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/route-stops/consequatur"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "label": "vmqeopfuudtdsufvyvddq",
    "sequence": 1,
    "status": "skipped",
    "notes": "mniihfqcoynlazghdtqtq",
    "visited_at": "2025-09-20T17:07:35",
    "retry_at": "2025-09-20T17:07:35",
    "outcome": "not_interested"
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

PUT api/route-stops/{routeStop_id}

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

routeStop_id   string   

The ID of the routeStop. Example: consequatur

Body Parameters

label   string  optional  

Must not be greater than 255 characters. Example: vmqeopfuudtdsufvyvddq

sequence   integer  optional  

Must be at least 0. Example: 1

status   string  optional  

Example: skipped

Must be one of:
  • pending
  • visited
  • skipped
  • postponed
notes   string  optional  

Must not be greater than 2000 characters. Example: mniihfqcoynlazghdtqtq

visited_at   string  optional  

Must be a valid date. Example: 2025-09-20T17:07:35

retry_at   string  optional  

Must be a valid date. Example: 2025-09-20T17:07:35

outcome   string  optional  

Example: not_interested

Must be one of:
  • no_decision_maker
  • closed
  • moved
  • not_interested
  • other

POST api/routes/optimize

Example request:
curl --request POST \
    "https://agentes-vendor-back.puntossmart.com/api/routes/optimize" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"stops\": [
        {
            \"latitude\": -89,
            \"longitude\": -180
        }
    ],
    \"profile\": \"walking\",
    \"roundtrip\": true
}"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/routes/optimize"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "stops": [
        {
            "latitude": -89,
            "longitude": -180
        }
    ],
    "profile": "walking",
    "roundtrip": true
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

POST api/routes/optimize

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Body Parameters

stops   object[]   

Must have at least 2 items.

latitude   number   

Must be between -90 and 90. Example: -89

longitude   number   

Must be between -180 and 180. Example: -180

profile   string  optional  

Example: walking

Must be one of:
  • driving
  • walking
roundtrip   boolean  optional  

Example: true

Retorna puntos para heatmap de compañías y usuarios (sin company) con pesos.

Se asume que companies tiene latitud/longitud y users puede derivarse de compañías o no.

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/heatmap/points" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/heatmap/points"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/heatmap/points could not be found."
}
 

Request      

GET api/heatmap/points

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

GET api/agenda/upcoming

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/agenda/upcoming" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/agenda/upcoming"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/agenda/upcoming could not be found."
}
 

Request      

GET api/agenda/upcoming

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

GET api/agenda-items

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/agenda-items" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/agenda-items"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/agenda-items could not be found."
}
 

Request      

GET api/agenda-items

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

POST api/agenda-items

Example request:
curl --request POST \
    "https://agentes-vendor-back.puntossmart.com/api/agenda-items" \
    --header "Content-Type: multipart/form-data" \
    --header "Accept: application/json" \
    --form "nombre_comercio=vmqeopfuudtdsufvyvddq"\
    --form "direccion=amniihfqcoynlazghdtqt"\
    --form "latitude=-89"\
    --form "longitude=-179"\
    --form "motivo_reagendo=closed_business"\
    --form "motivo_detalle=bajwbpilpmufinllwloau"\
    --form "fecha_reintento=2106-10-20"\
    --form "prioridad=media"\
    --form "notas_adicionales=mqeopfuudtdsufvyvddqa"\
    --form "fecha_visita_original=2025-09-20T17:07:35"\
    --form "foto_establecimiento=@/tmp/phpj4fE2n" 
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/agenda-items"
);

const headers = {
    "Content-Type": "multipart/form-data",
    "Accept": "application/json",
};

const body = new FormData();
body.append('nombre_comercio', 'vmqeopfuudtdsufvyvddq');
body.append('direccion', 'amniihfqcoynlazghdtqt');
body.append('latitude', '-89');
body.append('longitude', '-179');
body.append('motivo_reagendo', 'closed_business');
body.append('motivo_detalle', 'bajwbpilpmufinllwloau');
body.append('fecha_reintento', '2106-10-20');
body.append('prioridad', 'media');
body.append('notas_adicionales', 'mqeopfuudtdsufvyvddqa');
body.append('fecha_visita_original', '2025-09-20T17:07:35');
body.append('foto_establecimiento', document.querySelector('input[name="foto_establecimiento"]').files[0]);

fetch(url, {
    method: "POST",
    headers,
    body,
}).then(response => response.json());

Request      

POST api/agenda-items

Headers

Content-Type      

Example: multipart/form-data

Accept      

Example: application/json

Body Parameters

nombre_comercio   string   

Must not be greater than 255 characters. Example: vmqeopfuudtdsufvyvddq

direccion   string  optional  

Must not be greater than 500 characters. Example: amniihfqcoynlazghdtqt

latitude   number   

Must be between -90 and 90. Example: -89

longitude   number   

Must be between -180 and 180. Example: -179

motivo_reagendo   string   

Example: closed_business

Must be one of:
  • no_decision_maker
  • closed_business
  • meeting_scheduled
  • documents_needed
  • follow_up_required
  • other
motivo_detalle   string  optional  

Must not be greater than 1000 characters. Example: bajwbpilpmufinllwloau

fecha_reintento   string   

Must be a valid date. Must be a date after now. Example: 2106-10-20

foto_establecimiento   file  optional  

Must be a file. Must not be greater than 10240 kilobytes. Example: /tmp/phpj4fE2n

prioridad   string  optional  

Example: media

Must be one of:
  • baja
  • media
  • alta
notas_adicionales   string  optional  

Must not be greater than 1000 characters. Example: mqeopfuudtdsufvyvddqa

fecha_visita_original   string  optional  

Must be a valid date. Example: 2025-09-20T17:07:35

POST api/agenda-items/simple

Example request:
curl --request POST \
    "https://agentes-vendor-back.puntossmart.com/api/agenda-items/simple" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/agenda-items/simple"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());

Request      

POST api/agenda-items/simple

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

GET api/agenda-items/{agendaItem_id}

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/agenda-items/consequatur" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/agenda-items/consequatur"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/agenda-items/consequatur could not be found."
}
 

Request      

GET api/agenda-items/{agendaItem_id}

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

agendaItem_id   string   

The ID of the agendaItem. Example: consequatur

PUT api/agenda-items/{agendaItem_id}

Example request:
curl --request PUT \
    "https://agentes-vendor-back.puntossmart.com/api/agenda-items/consequatur" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"estado\": \"visitado\",
    \"prioridad\": \"alta\",
    \"notas_adicionales\": \"vmqeopfuudtdsufvyvddq\",
    \"fecha_completado\": \"2025-09-20T17:07:35\"
}"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/agenda-items/consequatur"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "estado": "visitado",
    "prioridad": "alta",
    "notas_adicionales": "vmqeopfuudtdsufvyvddq",
    "fecha_completado": "2025-09-20T17:07:35"
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

PUT api/agenda-items/{agendaItem_id}

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

agendaItem_id   string   

The ID of the agendaItem. Example: consequatur

Body Parameters

estado   string  optional  

Example: visitado

Must be one of:
  • pendiente
  • visitado
  • cancelado
prioridad   string  optional  

Example: alta

Must be one of:
  • baja
  • media
  • alta
notas_adicionales   string  optional  

Must not be greater than 1000 characters. Example: vmqeopfuudtdsufvyvddq

fecha_completado   string  optional  

Must be a valid date. Example: 2025-09-20T17:07:35

DELETE api/agenda-items/{agendaItem_id}

Example request:
curl --request DELETE \
    "https://agentes-vendor-back.puntossmart.com/api/agenda-items/consequatur" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/agenda-items/consequatur"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

Request      

DELETE api/agenda-items/{agendaItem_id}

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

agendaItem_id   string   

The ID of the agendaItem. Example: consequatur

GET api/agenda-items/proximas-visitas

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/agenda-items/proximas-visitas" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/agenda-items/proximas-visitas"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/agenda-items/proximas-visitas could not be found."
}
 

Request      

GET api/agenda-items/proximas-visitas

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Estadísticas para el dashboard del Vendor

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/dashboard/vendor-stats" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/dashboard/vendor-stats"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/dashboard/vendor-stats could not be found."
}
 

Request      

GET api/dashboard/vendor-stats

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Estadísticas para el dashboard del Vendedor

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/dashboard/vendedor-stats" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/dashboard/vendedor-stats"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/dashboard/vendedor-stats could not be found."
}
 

Request      

GET api/dashboard/vendedor-stats

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Alertas para el vendor

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/dashboard/vendor-alerts" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/dashboard/vendor-alerts"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/dashboard/vendor-alerts could not be found."
}
 

Request      

GET api/dashboard/vendor-alerts

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Actualizar ubicación del vendedor

Example request:
curl --request POST \
    "https://agentes-vendor-back.puntossmart.com/api/vendedores/update-location" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/vendedores/update-location"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());

Request      

POST api/vendedores/update-location

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Obtener ubicación actual del vendedor

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/vendedores/current-location" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/vendedores/current-location"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/vendedores/current-location could not be found."
}
 

Request      

GET api/vendedores/current-location

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Alternar estado activo/inactivo del vendedor

Example request:
curl --request POST \
    "https://agentes-vendor-back.puntossmart.com/api/vendedores/toggle-status" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/vendedores/toggle-status"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());

Request      

POST api/vendedores/toggle-status

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Obtener estado de vendedores en campo (para vendors)

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/vendedores/field-status" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/vendedores/field-status"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/vendedores/field-status could not be found."
}
 

Request      

GET api/vendedores/field-status

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Notificaciones para vendedores

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/notifications/vendedor" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/notifications/vendedor"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/notifications/vendedor could not be found."
}
 

Request      

GET api/notifications/vendedor

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

GET api/dashboard-counts

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/dashboard-counts" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/dashboard-counts"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/dashboard-counts could not be found."
}
 

Request      

GET api/dashboard-counts

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Auth

API para la gestión de autenticación

Iniciar sesion

Example request:
curl --request POST \
    "https://agentes-vendor-back.puntossmart.com/api/auth/signin" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"codigo\": \"vmqeopfuudtdsufvyvddqamniihfqcoynlazghdtqtqxbajwbpilpmufinllwloauydlsmsjury\",
    \"password\": \"UB)z&~na%x?(F|SF{9\"
}"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/auth/signin"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "codigo": "vmqeopfuudtdsufvyvddqamniihfqcoynlazghdtqtqxbajwbpilpmufinllwloauydlsmsjury",
    "password": "UB)z&~na%x?(F|SF{9"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

POST api/auth/signin

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Body Parameters

codigo   string   

Must be at least 8 characters. Example: vmqeopfuudtdsufvyvddqamniihfqcoynlazghdtqtqxbajwbpilpmufinllwloauydlsmsjury

password   string   

Must be at least 6 characters. Example: UB)z&~na%x?(F|SF{9

Informacion del usuario autenticado

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/auth/webuser" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/auth/webuser"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/auth/webuser could not be found."
}
 

Request      

GET api/auth/webuser

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

Cerrar sesion actual

requires authentication

Example request:
curl --request POST \
    "https://agentes-vendor-back.puntossmart.com/api/auth/weblogout" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/auth/weblogout"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());

Request      

POST api/auth/weblogout

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

Cerrar todas las sesiones

requires authentication

Example request:
curl --request POST \
    "https://agentes-vendor-back.puntossmart.com/api/auth/weblogoutall" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/auth/weblogoutall"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());

Request      

POST api/auth/weblogoutall

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

Cambiar contraseña

requires authentication

Example request:
curl --request POST \
    "https://agentes-vendor-back.puntossmart.com/api/auth/newpassword" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"new_password\": \"vmqeopfuudtdsufvyvddqamniihfqcoynlazghdtqtqxbajwbpilpmufinllwloauydlsmsjury\"
}"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/auth/newpassword"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "new_password": "vmqeopfuudtdsufvyvddqamniihfqcoynlazghdtqtqxbajwbpilpmufinllwloauydlsmsjury"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

POST api/auth/newpassword

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

Body Parameters

new_password   string   

Must be at least 8 characters. Example: vmqeopfuudtdsufvyvddqamniihfqcoynlazghdtqtqxbajwbpilpmufinllwloauydlsmsjury

Companies

Todas las companies

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/companies?limit=15&keyword=00000001" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/companies"
);

const params = {
    "limit": "15",
    "keyword": "00000001",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/companies could not be found."
}
 

Request      

GET api/companies

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

Query Parameters

limit   integer  optional  

Número de registros por página. Example: 15

keyword   string  optional  

Término de búsqueda para filtrar companies. Example: 00000001

GET api/countcompanies

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/countcompanies" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/countcompanies"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/countcompanies could not be found."
}
 

Request      

GET api/countcompanies

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

GET api/countafiliadores

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/countafiliadores" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/countafiliadores"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/countafiliadores could not be found."
}
 

Request      

GET api/countafiliadores

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

GET api/companiesforseller/{codigo_referido}

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/companiesforseller/consequatur" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/companiesforseller/consequatur"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/companiesforseller/consequatur could not be found."
}
 

Request      

GET api/companiesforseller/{codigo_referido}

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

codigo_referido   string   

Example: consequatur

GET api/companiesforyear/{año}/{mes?}

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/companiesforyear/consequatur/consequatur" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/companiesforyear/consequatur/consequatur"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/companiesforyear/consequatur/consequatur could not be found."
}
 

Request      

GET api/companiesforyear/{año}/{mes?}

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

año   string   

Example: consequatur

mes   string  optional  

Example: consequatur

GET api/companiesvsusers/{año}/{mes?}

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/companiesvsusers/consequatur/consequatur" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/companiesvsusers/consequatur/consequatur"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/companiesvsusers/consequatur/consequatur could not be found."
}
 

Request      

GET api/companiesvsusers/{año}/{mes?}

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

año   string   

Example: consequatur

mes   string  optional  

Example: consequatur

Opciones

Obtener opciones de vendedors

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/opcionesvendors" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/opcionesvendors"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/opcionesvendors could not be found."
}
 

Request      

GET api/opcionesvendors

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

Permisos

Todos los permisos

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/permisos?limit=15" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/permisos"
);

const params = {
    "limit": "15",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/permisos could not be found."
}
 

Request      

GET api/permisos

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

Query Parameters

limit   integer  optional  

Número de registros por página. Example: 15

Guardar permiso

requires authentication

Example request:
curl --request POST \
    "https://agentes-vendor-back.puntossmart.com/api/permisos" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"consequatur\"
}"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/permisos"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "name": "consequatur"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

POST api/permisos

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

Body Parameters

name   string   

Example: consequatur

Mostrar permiso por id

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/permisos/consequatur" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/permisos/consequatur"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/permisos/consequatur could not be found."
}
 

Request      

GET api/permisos/{id}

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   string   

The ID of the permiso. Example: consequatur

Actualizar permiso

requires authentication

Example request:
curl --request PUT \
    "https://agentes-vendor-back.puntossmart.com/api/permisos/consequatur" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"id\": \"consequatur\",
    \"name\": \"consequatur\"
}"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/permisos/consequatur"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "id": "consequatur",
    "name": "consequatur"
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

PUT api/permisos/{id}

PATCH api/permisos/{id}

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   string   

The ID of the permiso. Example: consequatur

Body Parameters

id   string   

Example: consequatur

name   string   

Example: consequatur

Eliminar permiso

requires authentication

Example request:
curl --request DELETE \
    "https://agentes-vendor-back.puntossmart.com/api/permisos/consequatur" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/permisos/consequatur"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

Request      

DELETE api/permisos/{id}

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   string   

The ID of the permiso. Example: consequatur

Todos los permisos

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/permisosall" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/permisosall"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/permisosall could not be found."
}
 

Request      

GET api/permisosall

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

Permisos por rol

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/permissionsforrole" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/permissionsforrole"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/permissionsforrole could not be found."
}
 

Request      

GET api/permissionsforrole

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

Roles

Todos los roles

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/roles?limit=15" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/roles"
);

const params = {
    "limit": "15",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/roles could not be found."
}
 

Request      

GET api/roles

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

Query Parameters

limit   integer  optional  

Número de registros por página. Example: 15

Crear role

requires authentication

Example request:
curl --request POST \
    "https://agentes-vendor-back.puntossmart.com/api/roles" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"superadmin\"
}"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/roles"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "name": "superadmin"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

POST api/roles

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

Body Parameters

name   string   

Nombre del role. Example: superadmin

Mostrar role por id

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/roles/consequatur" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/roles/consequatur"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/roles/consequatur could not be found."
}
 

Request      

GET api/roles/{id}

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   string   

The ID of the role. Example: consequatur

Actualizar role

requires authentication

Example request:
curl --request PUT \
    "https://agentes-vendor-back.puntossmart.com/api/roles/consequatur" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"id\": \"consequatur\",
    \"name\": \"consequatur\"
}"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/roles/consequatur"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "id": "consequatur",
    "name": "consequatur"
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Request      

PUT api/roles/{id}

PATCH api/roles/{id}

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   string   

The ID of the role. Example: consequatur

Body Parameters

id   string   

Example: consequatur

name   string   

Example: consequatur

Eliminar role

requires authentication

Example request:
curl --request DELETE \
    "https://agentes-vendor-back.puntossmart.com/api/roles/consequatur" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/roles/consequatur"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

Request      

DELETE api/roles/{id}

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   string   

The ID of the role. Example: consequatur

Todos los roles

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/rolesall" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/rolesall"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/rolesall could not be found."
}
 

Request      

GET api/rolesall

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

Sincronizar permisos de un rol

requires authentication

Example request:
curl --request POST \
    "https://agentes-vendor-back.puntossmart.com/api/syncRolePermissions" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/syncRolePermissions"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());

Request      

POST api/syncRolePermissions

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

Sucursales

GET api/sucursales/{id_company}

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/sucursales/consequatur" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/sucursales/consequatur"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/sucursales/consequatur could not be found."
}
 

Request      

GET api/sucursales/{id_company}

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id_company   string   

Example: consequatur

GET api/sucursales/cantidad

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/sucursales/cantidad" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/sucursales/cantidad"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/sucursales/cantidad could not be found."
}
 

Request      

GET api/sucursales/cantidad

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

Users

Todos los usuarios

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/users?limit=15&keyword=juan%40gmail.com" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/users"
);

const params = {
    "limit": "15",
    "keyword": "juan@gmail.com",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/users could not be found."
}
 

Request      

GET api/users

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

Query Parameters

limit   integer  optional  

Número de registros por página. Example: 15

keyword   string  optional  

Término de búsqueda para filtrar usuarios. Example: juan@gmail.com

Crear usuario

requires authentication

Example request:
curl --request POST \
    "https://agentes-vendor-back.puntossmart.com/api/users" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/users"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "POST",
    headers,
}).then(response => response.json());

Request      

POST api/users

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

Mostrar usuario por id

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/users/consequatur" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/users/consequatur"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/users/consequatur could not be found."
}
 

Request      

GET api/users/{id}

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   string   

The ID of the user. Example: consequatur

Actualizar usuario

requires authentication

Example request:
curl --request PUT \
    "https://agentes-vendor-back.puntossmart.com/api/users/consequatur" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/users/consequatur"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "PUT",
    headers,
}).then(response => response.json());

Request      

PUT api/users/{id}

PATCH api/users/{id}

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   string   

The ID of the user. Example: consequatur

Eliminar usuario

requires authentication

Example request:
curl --request DELETE \
    "https://agentes-vendor-back.puntossmart.com/api/users/consequatur" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/users/consequatur"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

Request      

DELETE api/users/{id}

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   string   

The ID of the user. Example: consequatur

Usuarios Smart

GET api/usersforyear/{año}/{mes?}

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/usersforyear/consequatur/consequatur" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/usersforyear/consequatur/consequatur"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/usersforyear/consequatur/consequatur could not be found."
}
 

Request      

GET api/usersforyear/{año}/{mes?}

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

año   string   

Example: consequatur

mes   string  optional  

Example: consequatur

Lista todos los usuarios smart registrados

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/userssmart?limit=17&keyword=consequatur" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/userssmart"
);

const params = {
    "limit": "17",
    "keyword": "consequatur",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/userssmart could not be found."
}
 

Request      

GET api/userssmart

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

Query Parameters

limit   integer  optional  

Numero de registros por pagina. Default 15. Example: 17

keyword   string  optional  

Buscar por nombre, apellido, telefono, numero de documento, codigo de referencia o email. Example: consequatur

Vendedores

Cantidad de usuarios smart registrados en la aplicacion

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/usuariossamartregistrados" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/usuariossamartregistrados"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/usuariossamartregistrados could not be found."
}
 

Request      

GET api/usuariossamartregistrados

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

Cantidad de vendedores por estado

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/vendedores/estado" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/vendedores/estado"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/vendedores/estado could not be found."
}
 

Request      

GET api/vendedores/estado

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

GET api/rankingvendedores/{año}/{mes?}

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/rankingvendedores/consequatur/consequatur" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/rankingvendedores/consequatur/consequatur"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/rankingvendedores/consequatur/consequatur could not be found."
}
 

Request      

GET api/rankingvendedores/{año}/{mes?}

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

año   string   

Example: consequatur

mes   string  optional  

Example: consequatur

Todos los vendedores

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/vendedores?limit=15" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/vendedores"
);

const params = {
    "limit": "15",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/vendedores could not be found."
}
 

Request      

GET api/vendedores

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

Query Parameters

limit   integer  optional  

Número de registros por página. Example: 15

Crear vendedor

requires authentication

Example request:
curl --request POST \
    "https://agentes-vendor-back.puntossmart.com/api/vendedores" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"nro_doc_identidad\": \"vmqeopfuudtdsufvyvddqamniihfqcoynlazghdtqtqxbajwbpilpmufinllwloauydlsmsjury\",
    \"email\": \"jmacejkovic@example.com\",
    \"apellido_paterno\": \"ybzvrbyickznkygloigmk\",
    \"apellido_materno\": \"wxphlvazjrcnfbaqywuxh\",
    \"nombres\": \"gjjmzuxjubqouzswiwxtr\",
    \"tipo_documento_identidad\": \"kimfcatbxspzmrazsroyj\",
    \"genero\": \"pxmqesedyghenqcopwvow\",
    \"celular\": \"nkbamlnfngefbeilfzsyu\"
}"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/vendedores"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "nro_doc_identidad": "vmqeopfuudtdsufvyvddqamniihfqcoynlazghdtqtqxbajwbpilpmufinllwloauydlsmsjury",
    "email": "jmacejkovic@example.com",
    "apellido_paterno": "ybzvrbyickznkygloigmk",
    "apellido_materno": "wxphlvazjrcnfbaqywuxh",
    "nombres": "gjjmzuxjubqouzswiwxtr",
    "tipo_documento_identidad": "kimfcatbxspzmrazsroyj",
    "genero": "pxmqesedyghenqcopwvow",
    "celular": "nkbamlnfngefbeilfzsyu"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (201, success):


{
    "message": "Vendedor creado correctamente"
}
 

Example response (422, DNI duplicado):


{
    "message": "Error de validación",
    "errors": {
        "nro_doc_identidad": [
            "El número de documento ya está registrado en el sistema."
        ]
    }
}
 

Example response (422, Email duplicado):


{
    "message": "Error de validación",
    "errors": {
        "email": [
            "El correo electrónico ya está registrado en el sistema."
        ]
    }
}
 

Example response (500, Error del servidor):


{
    "message": "Error al procesar la solicitud",
    "error": "Mensaje detallado del error"
}
 

Request      

POST api/vendedores

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

Body Parameters

nro_doc_identidad   string   

Must match the regex /^[0-9]+$/. Must not be greater than 8 characters. Must be at least 8 characters. Example: vmqeopfuudtdsufvyvddqamniihfqcoynlazghdtqtqxbajwbpilpmufinllwloauydlsmsjury

email   string   

Must be a valid email address. Must not be greater than 255 characters. Example: jmacejkovic@example.com

apellido_paterno   string   

Must not be greater than 255 characters. Example: ybzvrbyickznkygloigmk

apellido_materno   string   

Must not be greater than 255 characters. Example: wxphlvazjrcnfbaqywuxh

nombres   string   

Must not be greater than 255 characters. Example: gjjmzuxjubqouzswiwxtr

tipo_documento_identidad   string   

Must not be greater than 255 characters. Example: kimfcatbxspzmrazsroyj

genero   string   

Must not be greater than 255 characters. Example: pxmqesedyghenqcopwvow

celular   string   

Must not be greater than 255 characters. Example: nkbamlnfngefbeilfzsyu

Mostrar vendedor por id

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/vendedores/consequatur" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/vendedores/consequatur"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/vendedores/consequatur could not be found."
}
 

Request      

GET api/vendedores/{id}

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   string   

The ID of the vendedore. Example: consequatur

Actualizar vendedor

requires authentication

Example request:
curl --request PUT \
    "https://agentes-vendor-back.puntossmart.com/api/vendedores/consequatur" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"nro_doc_identidad\": \"vmqeopfu\",
    \"email\": \"tcollins@example.com\",
    \"apellido_paterno\": \"sufvyvddqamniihfqcoyn\",
    \"apellido_materno\": \"lazghdtqtqxbajwbpilpm\",
    \"nombres\": \"ufinllwloauydlsmsjury\",
    \"tipo_documento_identidad\": \"vojcybzvrbyickznkyglo\",
    \"genero\": \"igmkwxphlvazjrcnfbaqy\",
    \"celular\": \"wuxhgjjmzuxjubqouzswi\",
    \"estado\": \"consequatur\"
}"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/vendedores/consequatur"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "nro_doc_identidad": "vmqeopfu",
    "email": "tcollins@example.com",
    "apellido_paterno": "sufvyvddqamniihfqcoyn",
    "apellido_materno": "lazghdtqtqxbajwbpilpm",
    "nombres": "ufinllwloauydlsmsjury",
    "tipo_documento_identidad": "vojcybzvrbyickznkyglo",
    "genero": "igmkwxphlvazjrcnfbaqy",
    "celular": "wuxhgjjmzuxjubqouzswi",
    "estado": "consequatur"
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200, success):


{
    "message": "Vendedor Actualizado correctamente"
}
 

Example response (422, DNI duplicado):


{
    "message": "Error de validación",
    "errors": {
        "nro_doc_identidad": [
            "El número de documento ya está registrado en el sistema."
        ]
    }
}
 

Example response (422, Email duplicado):


{
    "message": "Error de validación",
    "errors": {
        "email": [
            "El correo electrónico ya está registrado en el sistema."
        ]
    }
}
 

Example response (500, Error del servidor):


{
    "message": "Error al procesar la solicitud",
    "error": "Mensaje detallado del error"
}
 

Request      

PUT api/vendedores/{id}

PATCH api/vendedores/{id}

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   string   

The ID of the vendedore. Example: consequatur

Body Parameters

nro_doc_identidad   string   

Must match the regex /^[0-9]+$/. Must be 8 characters. Example: vmqeopfu

email   string   

Must be a valid email address. Must not be greater than 255 characters. Example: tcollins@example.com

apellido_paterno   string   

Must not be greater than 255 characters. Example: sufvyvddqamniihfqcoyn

apellido_materno   string   

Must not be greater than 255 characters. Example: lazghdtqtqxbajwbpilpm

nombres   string   

Must not be greater than 255 characters. Example: ufinllwloauydlsmsjury

tipo_documento_identidad   string   

Must not be greater than 255 characters. Example: vojcybzvrbyickznkyglo

genero   string   

Must not be greater than 255 characters. Example: igmkwxphlvazjrcnfbaqy

celular   string   

Must not be greater than 255 characters. Example: wuxhgjjmzuxjubqouzswi

estado   string   

Example: consequatur

Eliminar vendedor

requires authentication

Example request:
curl --request DELETE \
    "https://agentes-vendor-back.puntossmart.com/api/vendedores/consequatur" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/vendedores/consequatur"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

Request      

DELETE api/vendedores/{id}

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   string   

The ID of the vendedore. Example: consequatur

Vendors

API para la gestión de vendors

Mostrar lista de vendors

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/vendors?limit=15&keyword=00000001" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/vendors"
);

const params = {
    "limit": "15",
    "keyword": "00000001",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/vendors could not be found."
}
 

Request      

GET api/vendors

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

Query Parameters

limit   integer  optional  

Número de registros por página. Example: 15

keyword   string  optional  

Término de búsqueda para filtrar vendors. Example: 00000001

Crear vendor

requires authentication

Example request:
curl --request POST \
    "https://agentes-vendor-back.puntossmart.com/api/vendors" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"apellido_paterno\": \"Pérez\",
    \"apellido_materno\": \"García\",
    \"nombres\": \"Juan\",
    \"tipo_documento_identidad\": \"DNI\",
    \"nro_doc_identidad\": \"12345678\",
    \"genero\": \"M\",
    \"celular\": \"999888777\",
    \"email\": \"juan@example.com\",
    \"fecha_inicio\": \"2024-01-01\"
}"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/vendors"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "apellido_paterno": "Pérez",
    "apellido_materno": "García",
    "nombres": "Juan",
    "tipo_documento_identidad": "DNI",
    "nro_doc_identidad": "12345678",
    "genero": "M",
    "celular": "999888777",
    "email": "juan@example.com",
    "fecha_inicio": "2024-01-01"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (201, success):


{
    "message": "Vendor creado correctamente"
}
 

Example response (422, DNI duplicado):


{
    "message": "Error de validación",
    "errors": {
        "nro_doc_identidad": [
            "El número de documento ya está registrado en el sistema."
        ]
    }
}
 

Example response (422, Email duplicado):


{
    "message": "Error de validación",
    "errors": {
        "email": [
            "El correo electrónico ya está registrado en el sistema."
        ]
    }
}
 

Example response (500, Error del servidor):


{
    "message": "Error al procesar la solicitud",
    "error": "Mensaje detallado del error"
}
 

Request      

POST api/vendors

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

Body Parameters

apellido_paterno   string   

Apellido paterno del vendedor. Example: Pérez

apellido_materno   string   

Apellido materno del vendedor. Example: García

nombres   string   

Nombres del vendedor. Example: Juan

tipo_documento_identidad   string   

Tipo de documento. Example: DNI

nro_doc_identidad   string   

Número de documento. Example: 12345678

genero   string   

Género del vendedor. Example: M

celular   string   

Número de celular. Example: 999888777

email   string   

Correo electrónico. Example: juan@example.com

fecha_inicio   date   

Fecha de inicio. Example: 2024-01-01

Obtener vendor por id

requires authentication

Example request:
curl --request GET \
    --get "https://agentes-vendor-back.puntossmart.com/api/vendors/9fe56824-0d66-40e1-ae61-67dcbb7c8d35" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/vendors/9fe56824-0d66-40e1-ae61-67dcbb7c8d35"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

Example response (404):

Show headers
cache-control: no-cache, private
content-type: application/json
vary: Origin
 

{
    "message": "The route api/vendors/9fe56824-0d66-40e1-ae61-67dcbb7c8d35 could not be found."
}
 

Request      

GET api/vendors/{id}

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   string   

The ID of the vendor. Example: 9fe56824-0d66-40e1-ae61-67dcbb7c8d35

Actualizar vendor por id

requires authentication

Example request:
curl --request PUT \
    "https://agentes-vendor-back.puntossmart.com/api/vendors/9fe56824-0d66-40e1-ae61-67dcbb7c8d35" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"nro_doc_identidad\": \"12345678\",
    \"email\": \"juan@example.com\",
    \"apellido_paterno\": \"Pérez\",
    \"apellido_materno\": \"García\",
    \"nombres\": \"Juan\",
    \"tipo_documento_identidad\": \"DNI\",
    \"genero\": \"M\",
    \"celular\": \"999888777\",
    \"estado\": \"consequatur\",
    \"fecha_inicio\": \"2024-01-01\"
}"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/vendors/9fe56824-0d66-40e1-ae61-67dcbb7c8d35"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "nro_doc_identidad": "12345678",
    "email": "juan@example.com",
    "apellido_paterno": "Pérez",
    "apellido_materno": "García",
    "nombres": "Juan",
    "tipo_documento_identidad": "DNI",
    "genero": "M",
    "celular": "999888777",
    "estado": "consequatur",
    "fecha_inicio": "2024-01-01"
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

Example response (200, success):


{
    "message": "Vendor actualizado correctamente"
}
 

Example response (422, DNI duplicado):


{
    "message": "Error de validación",
    "errors": {
        "nro_doc_identidad": [
            "El número de documento ya está registrado en el sistema."
        ]
    }
}
 

Example response (422, Email duplicado):


{
    "message": "Error de validación",
    "errors": {
        "email": [
            "El correo electrónico ya está registrado en el sistema."
        ]
    }
}
 

Example response (500, Error del servidor):


{
    "message": "Error al procesar la solicitud",
    "error": "Mensaje detallado del error"
}
 

Request      

PUT api/vendors/{id}

PATCH api/vendors/{id}

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   string   

The ID of the vendor. Example: 9fe56824-0d66-40e1-ae61-67dcbb7c8d35

Body Parameters

nro_doc_identidad   string   

Número de documento. Example: 12345678

email   string   

Correo electrónico. Example: juan@example.com

apellido_paterno   string   

Apellido paterno del vendedor. Example: Pérez

apellido_materno   string   

Apellido materno del vendedor. Example: García

nombres   string   

Nombres del vendedor. Example: Juan

tipo_documento_identidad   string   

Tipo de documento. Example: DNI

genero   string   

Género del vendedor. Example: M

celular   string   

Número de celular. Example: 999888777

estado   string   

Example: consequatur

fecha_inicio   date   

Fecha de inicio. Example: 2024-01-01

Eliminar vendor

requires authentication

Example request:
curl --request DELETE \
    "https://agentes-vendor-back.puntossmart.com/api/vendors/9fe56824-0d66-40e1-ae61-67dcbb7c8d35" \
    --header "Authorization: Bearer &lt;token&gt;" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
const url = new URL(
    "https://agentes-vendor-back.puntossmart.com/api/vendors/9fe56824-0d66-40e1-ae61-67dcbb7c8d35"
);

const headers = {
    "Authorization": "Bearer &lt;token&gt;",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());

Request      

DELETE api/vendors/{id}

Headers

Authorization      

Example: Bearer <token>

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   string   

The ID of the vendor. Example: 9fe56824-0d66-40e1-ae61-67dcbb7c8d35