register`

Registra un nuevo cliente en el sistema.

📍 Ruta

POST /api/clients/register

📝 Descripción

Este endpoint permite registrar un nuevo cliente en el sistema, siempre que se proporcione toda la información requerida y el Ruc y el email no estén ya registrados.

🔐 Autenticación

Requiere token JWT válido

Cabecera: Authorization: Bearer <token>

Middleware: verificarAutenticacion

🧰 Middleware

verificarAutenticacion

validateCreateClient

validateRequest

📦 Request Body

Debe incluir todos los campos requeridos para el registro:

{
  "Name": "string",
  "Ruc": "number",
  "Address": "string",
  "telephone": "number",
  "email": "string",
  "credit": "string",
  "state": "string"
}

✅ Respuestas

✔️ 201 Created – Cliente registrado exitosamente

{
  "status": "success",
  "code": "CLIENT_REGISTERED",
  "msg": "Cliente registrado con éxito.",
  "data": {
    "_id": "ObjectId",
    "Name": "string",
    "Ruc": number,
    "Address": "string",
    "telephone": number,
    "email": "string",
    "credit": "string",
    "state": "string"
  }
}

❌ Errores

🚫 400 Bad Request – Campos faltantes o inválidos

{
  "status": "error",
  "code": "MISSING_FIELD",
  "msg": "Los campos 'Ruc' y 'email' son obligatorios."
}

🔐 401 Unauthorized – Token inválido o ausente

{
  "status": "error",
  "code": "AUTH_ERROR",
  "msg": "Acceso no autorizado. Se requiere token válido."
}

⚠️ 409 Conflict – RUC o Email ya registrados

{
  "status": "error",
  "code": "RESOURCE_ALREADY_EXISTS",
  "msg": "El cliente con RUC '{Ruc}' ya existe."
}

{
  "status": "error",
  "code": "RESOURCE_ALREADY_EXISTS",
  "msg": "El email '{email}' ya está registrado por otro cliente."
}

💥 500 Internal Server Error – Error inesperado

{
  "status": "error",
  "code": "SERVER_ERROR",
  "msg": "Ha ocurrido un error inesperado al registrar el cliente. Intente de nuevo más tarde."
}

curl --location --request POST 'https://back-prima-s-a.onrender.com/api/clients/register' \ --header 'User-Agent: insomnia/11.0.0' \ --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3NjI0ZjkwNzY2OWM5MDZjYTM0YThkZSIsInJvbCI6ImFkbWluIiwiaWF0IjoxNzQyOTMxNzg3LCJleHAiOjE3NDI5NjA1ODd9.nwBdY2DmiTAjEYfxGukAQHJkbrsLHqMosjmOSgzfbR4' \ --header 'Content-Type: application/json' \ --data-raw '{ "Name": "Kiwi", "ComercialName": "Electrodomésticos Kiwi S.A.", "Ruc": "2351546276001", "Address": "Av. Amazonas N35-25 y Juan Pablo Sanz", "telephone": "0987654321", "email": "info5367@electromoderna.ec", "credit": "60 días", "state": "en deuda" }'

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Content-Type

string

optional

Example:

application/json

User-Agent

string

optional

Example:

insomnia/11.0.0

Authorization

string

optional

Example:

Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3NjI0ZjkwNzY2OWM5MDZjYTM0YThkZSIsInJvbCI6ImFkbWluIiwiaWF0IjoxNzQyOTMxNzg3LCJleHAiOjE3NDI5NjA1ODd9.nwBdY2DmiTAjEYfxGukAQHJkbrsLHqMosjmOSgzfbR4

Body Params application/json

Name

string

required

Ruc

integer

required

Address

string

required

telephone

integer

required

string

required

credit

string

required

state

string

required

Examples

Registrar Cliente

📝 POST `/clients/register`

📍 Ruta

📝 Descripción

🔐 Autenticación

🧰 Middleware

📦 Request Body

✅ Respuestas

✔️ 201 Created – Cliente registrado exitosamente

❌ Errores

🚫 400 Bad Request – Campos faltantes o inválidos

🔐 401 Unauthorized – Token inválido o ausente

⚠️ 409 Conflict – RUC o Email ya registrados

💥 500 Internal Server Error – Error inesperado

Request

Responses

Registrar Cliente

📝 POST /clients/register#

📍 Ruta#

📝 Descripción#

🔐 Autenticación#

🧰 Middleware#

📦 Request Body#

✅ Respuestas#

✔️ 201 Created – Cliente registrado exitosamente#

❌ Errores#

🚫 400 Bad Request – Campos faltantes o inválidos#

🔐 401 Unauthorized – Token inválido o ausente#

⚠️ 409 Conflict – RUC o Email ya registrados#

💥 500 Internal Server Error – Error inesperado#

Request

Responses

📝 POST `/clients/register`

📍 Ruta

📝 Descripción

🔐 Autenticación

🧰 Middleware

📦 Request Body

✅ Respuestas

✔️ 201 Created – Cliente registrado exitosamente

❌ Errores

🚫 400 Bad Request – Campos faltantes o inválidos

🔐 401 Unauthorized – Token inválido o ausente

⚠️ 409 Conflict – RUC o Email ya registrados

💥 500 Internal Server Error – Error inesperado