Skip to main content
Usa la API de Commerce desde tu backend para administrar items vendibles y sincronizar ventas con tus propios sistemas. Todos los endpoints usan la URL base M2M:
Las credenciales M2M son secretos de servidor. No llames estos endpoints desde navegador, móvil ni widgets incrustados.

Scopes

Las rutas de commerce usan el tenant asociado a la credencial M2M. No envíes tenantId en path ni query string.

Modelo de item

scope es global salvo que el item esté asignado a una propiedad. Los items por propiedad incluyen propertyId.

Listar items

Requiere commerce:items:read.

Crear un item

Requiere commerce:items:write.
Respuesta:
Tipos de campo soportados: text, number, email, phone, date y select.

Consultar un item

Requiere commerce:items:read.

Actualizar un item

Requiere commerce:items:write. Envía solo los campos que quieras cambiar.

Asignar scope de item

Requiere commerce:items:write. Asignar el item a una propiedad activa:
Hacer el item global:
Respuesta:

Eliminar un item

Requiere commerce:items:write.

Ventas

Las ventas son compras de commerce expuestas con nombres de ruta orientados a sistemas externos.

Listar ventas

Requiere commerce:sales:read. Query parameters: Respuesta:

Consultar una venta

Requiere commerce:sales:read.
Los objetos de venta incluyen estado de pago, fulfillment, campos de transfer/refund, datos capturados en checkout, conversación vinculada cuando exista, y detalles de reservación para pagos de depósito.