Editar carrito

Actualiza la información de un carrito existente, incluyendo datos del cliente, moneda y las mercaderías o servicios incluidos.

---

Entorno

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

Endpoint

PUT /carritos/{id}

Ejemplo de solicitud

# USD
curl -X PUT "https://api.guarani.app/carritos/{id}" \
  -H "Content-Type: application/json" \
  -H "x-api-key: Bearer <access_token>" \
  -d '{
    "cliente_id": "ejemplo-uuid-cliente-123"
  }' | jq

# PYG
curl -X PUT "https://api.guarani.app/carritos/{id}" \
  -H "Content-Type: application/json" \
  -H "x-api-key: Bearer <access_token>" \
  -d '{
    "cliente_id": "ejemplo-uuid-cliente-123"
  }' | jq

Nota: Reemplaza {id} por el ID del carrito y <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.

---

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
id	uuid	Sí	ID del carrito que se desea editar. (ver carritos)

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
cliente_id	uuid	Sí	36	Identificador único del cliente que realiza el pedido. (ver clientes)

Ejemplo de respuesta

{
  "success": true,
  "codigo": "200",
  "message": "Recurso actualizado con éxito.",
  "data": {
    "id": "ejemplo-uuid-carrito-123",
    "numero_documento": null,
    "estado_carrito": 1,
    "fecha_emision_documento": null,
    "fecha_finalizado": null,
    "numero_timbrado": null,
    "cdc": null,
    "moneda": "PYG",
    "cotizacion": 1,
    "total": 0,
    "cliente": {
      "id": "ejemplo-uuid-cliente-123",
      "tipo_persona": 1,
      "tipo_documento": 1,
      "documento": "1234567",
      "nombre": "NOMBRE DE EJEMPLO",
      "nombre_fantasia": "NOMBRE DE EJEMPLO",
      "nacionalidad": "PRY",
      "fecha_nacimiento": "22/03/2007",
      "whatsapp": "+595981234567",
      "email": "[email protected]",
      "numero_casa": "0",
      "direccion": "DIRECCION DE EJEMPLO",
      "barrio": "BARRIO DE EJEMPLO",
      "ciudad": {
        "id": "67ef2e9f-0fa7-43e7-ad5e-87a694e56341",
        "codigo_sifen": "3556",
        "nombre": "SANTA RITA",
        "distrito": {
          "id": "78d49201-91f9-4e6c-aadb-4927f56767c0",
          "nombre": "SANTA RITA",
          "codigo_sifen": "209"
        },
        "departamento": {
          "id": "750d3163-6a53-45df-b349-e8139d1ff3a9",
          "nombre": "ALTO PARANA",
          "codigo_sifen": "11"
        }
      }
    },
    "items": []
  }
}

Descripción de Campos de Respuesta

Campos Principales

Campo	Tipo	Descripción
id	uuid	Identificador único del carrito actualizado.
numero_documento	string	Número del documento asociado. Es null hasta que el carrito se finalice y se emita la factura.
estado_carrito	number	Estado actual del carrito. (ver tablas-referencias)
fecha_emision_documento	string	Fecha y hora de emisión del documento. Es null hasta que se finalice el carrito.
fecha_finalizado	string	Fecha y hora en que se finalizó el carrito. Es null mientras el carrito esté activo.
numero_timbrado	string	Número de timbrado asociado. Es null hasta que el carrito se finalice y se emita la factura.
cdc	string	Código de control del carrito. Es null hasta que el carrito se finalice y se emita la factura.
moneda	string	Código de moneda en formato ISO 4217 (ej: PYG, USD).
cotizacion	number	Cotización de la moneda respecto a Guaraníes.
total	number	Monto total del carrito en la moneda especificada.
cliente	object	Objeto con la información completa del cliente asociado al carrito.
items	array	Lista de productos/servicios agregados al carrito.

Campos del Cliente

Campo	Tipo	Descripción
id	uuid	Identificador único del cliente.
tipo_persona	number	Tipo de persona. 1 = Persona Física, 2 = Persona Jurídica.
tipo_documento	number	Tipo de documento de identidad. 1 = Cédula, 2 = Pasaporte, 3 = RUC, etc.
documento	string	Número del documento de identidad del cliente.
nombre	string	Nombre completo del cliente (razón social para personas jurídicas).
nombre_fantasia	string	Nombre comercial o fantasía del cliente.
nacionalidad	string	Código de nacionalidad en formato ISO 3166-1 alpha-3 (ej: PRY, ARG, BRA).
fecha_nacimiento	string	Fecha de nacimiento del cliente en formato DD/MM/YYYY.
whatsapp	string	Número de WhatsApp del cliente en formato internacional.
email	string	Dirección de correo electrónico del cliente.
numero_casa	string	Número de casa o edificio de la dirección del cliente.
direccion	string	Dirección completa del cliente.
barrio	string	Nombre del barrio donde reside el cliente.
ciudad	object	Objeto con información de la ciudad del cliente.

Campos de Ciudad

Campo	Tipo	Descripción
id	uuid	Identificador único de la ciudad.
codigo_sifen	string	Código de la ciudad según el catálogo SIFEN.
nombre	string	Nombre de la ciudad.
distrito	object	Objeto con información del distrito al que pertenece la ciudad.
departamento	object	Objeto con información del departamento al que pertenece la ciudad.

Campos de Distrito

Campo	Tipo	Descripción
id	uuid	Identificador único del distrito.
nombre	string	Nombre del distrito.
codigo_sifen	string	Código del distrito según el catálogo SIFEN.

Campos de Departamento

Campo	Tipo	Descripción
id	uuid	Identificador único del departamento.
nombre	string	Nombre del departamento.
codigo_sifen	string	Código del departamento según el catálogo SIFEN.

Recursos adicionales

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