Crear servicio

Registra un nuevo servicio en el sistema. Permite crear servicios con sus datos básicos y configuración.

---

Entorno

URL Base: https://api.guarani.app

Endpoint

POST /servicios

Ejemplo de solicitud

curl -X POST "https://api.guarani.app/servicios" \
  -H "Content-Type: application/json" \
  -H "x-api-key: Bearer <access_token>" \
  -d '{
    "codigo_interno": "02-1234567",
    "descripcion": "DESCRIPCION DE EJEMPLO",
    "descripcion_larga": "DESCRIPCION LARGA DE EJEMPLO",
    "observacion": "OBSERVACION DE EJEMPLO",
    "unidad_medida_venta_id": "5f49c6c1-d622-4f5b-9d8b-2d1636b584ab",
    "precio_unitario": {
      "0": 7000,
      "5": 0,
      "10": 3300
    },
    "moneda": "PYG",
    "establecimiento_id": "ejemplo-uuid-establecimiento-123"
  }' | jq

Nota: Asegúrate de reemplazar <access_token> con un token JWT válido proporcionado por el equipo Guarani.
Importante:
Es imprescindible incluir un token de acceso válido en el encabezado x-api-key para autenticar y autorizar el uso de este endpoint. Sin este token, la solicitud será rechazada.

---

Encabezados de la Solicitud

Encabezado	Valor	Descripción
Content-Type	application/json	Indica que los datos se envían en formato JSON.
x-api-key	Bearer <access_token>	Token de autenticación necesario para acceder al recurso.

Descripción de Campos

Campo	Tipo	Requerido	Tamaño	Descripción
codigo_interno	string	Sí	20	Código identificador interno del servicio. (Ver código interno)
descripcion	string	Sí	120	Descripción corta del servicio.
descripcion_larga	string	No	500	Descripción detallada o técnica del servicio.
observacion	string	No	500	Observaciones adicionales o uso interno.
unidad_medida_venta_id	uuid	Sí	36	ID de la unidad de medida. (ver unidades)
servicio_clasificacion_id	uuid	No	36	ID de la clasificación del servicio. (ver clasificaciones)
precio_unitario	objeto	Sí	-	Objeto con los precios por tipo de IVA.
moneda	string	Sí	3	Moneda del precio (por ejemplo, PYG, USD).
establecimiento_id	uuid	Sí	36	ID del establecimiento donde se ofrece el servicio. (ver establecimientos)

precio_unitario (objeto)

Campo	Tipo	Requerido	Descripción
0	number	No	Precio con IVA 0% (exento)
5	number	No	Precio con IVA 5%
10	number	No	Precio con IVA 10%

Ejemplo de respuesta

{
  "success": true,
  "codigo": "201",
  "message": "Recurso creado con éxito.",
  "data": {
    "id": "ejemplo-uuid-servicio-123",
    "descripcion": "Servicio de Desarrollo Web",
    "descripcion_larga": "DESCRIPCION LARGA DE EJEMPLO",
    "observacion": "OBSERVACION DE EJEMPLO",
    "imagen_url": null,
    "codigo_interno": "02-1234567",
    "unidad_medida": {
      "id": "5f49c6c1-d622-4f5b-9d8b-2d1636b584ab",
      "representacion": "UNI",
      "descripcion": "Unidad"
    },
    "servicio_clasificacion": {
      "id": "00000000-0000-4000-8000-000000000000",
      "codigo": "99",
      "nombre": "Sin definir"
    },
    "precio_unitario": {
      "0": 7000,
      "5": 0,
      "10": 3300
    },
    "moneda": "PYG",
    "establecimiento_id": "ejemplo-uuid-establecimiento-123"
  }
}

Descripción de Campos de Respuesta

Campos principales

Campo	Tipo	Descripción
id	uuid	Identificador único del servicio creado.
descripcion	string	Descripción corta del servicio.
descripcion_larga	string	Descripción detallada o técnica del servicio.
observacion	string	Observaciones adicionales o notas internas.
imagen_url	string	URL de la imagen del servicio (puede ser null).
codigo_interno	string	Código interno del servicio.
unidad_medida	objeto	Información de la unidad de medida asociada al servicio.
servicio_clasificacion	objeto	Clasificación asignada al servicio.
precio_unitario	objeto	Precios por tipo de IVA (0, 5, 10).
moneda	string	Moneda del precio en formato ISO 4217 (ej.: PYG, USD).
establecimiento_id	uuid	ID del establecimiento donde se registra el servicio.

Campos de unidad_medida

Campo	Tipo	Descripción
id	uuid	Identificador de la unidad de medida.
representacion	string	Representación abreviada (ej.: UNI).
descripcion	string	Descripción de la unidad de medida.

Campos de servicio_clasificacion

Campo	Tipo	Descripción
id	uuid	Identificador de la clasificación del servicio.
codigo	string	Código de la clasificación.
nombre	string	Nombre de la clasificación.

Campos de precio_unitario

Campo	Tipo	Descripción
0	number	Precio con IVA 0% (exento)
5	number	Precio con IVA 5%
10	number	Precio con IVA 10%

Recursos adicionales

Para más información sobre posibles errores y cómo manejarlos, consulta errores.