Crear un negocio
API operation: Abrir la operación en la Referencia de la API
Usa POST /business para crear un negocio. La operación pública actual es Business.register.
Si está disponible, la operación requiere autenticarse como administrador o administrador de negocio. Los campos obligatorios actualmente incluyen name, email, slug, minimum, delivery_price, tax_type, tax y service_fee. Otros requisitos dependen de los campos seleccionados y de la configuración del proyecto; consulta el esquema de la operación para el esquema completo de la solicitud.
La operación valida o normaliza campos estructurados como schedule, types, taxes y ribbon. Los campos multimedia como logo, header y seo_image se procesan como imágenes. No incluyas credenciales de proveedores, datos de clientes ni identificadores exclusivos de producción en ejemplos.
Ejemplo de SDK heredado
const response = await ordering.businesses().save()
Confirma el paquete y la versión del SDK antes de usar este helper. Consulta la operación POST /business para conocer el contrato exacto.
Referencia de OpenAPI
Operación: POST /business
Campos del cuerpo de la solicitud
| Nombre | Tipo | Obligatorio |
|---|---|---|
about | any | No |
address | any | No |
address_notes | any | No |
always_deliver | boolean | No |
cancel_order_after_minutes | integer | null | No |
cellphone | any | No |
city_id | integer | No |
city_name | any | No |
country | any | No |
country_code | any | No |
currency | any | No |
delivery_price | number | Sí |
delivery_tax_rate | number | No |
delivery_tax_type | number | No |
delivery_time | any | No |
description | any | No |
disabled_reason | any | No |
email | any | Sí |
enabled | boolean | No |
eta_status_times | string | No |
eta_variation_time | integer | No |
external_id | any | No |
featured | boolean | No |
fixed_usage_fee | number | No |
franchise_id | integer | null | No |
front_layout | any | No |
header | any | No |
locality | any | No |
location | string | No |
logo | any | No |
maximum | number | null | No |
minimum | number | Sí |
name | any | Sí |
neighborhood | any | No |
order_default_priority | integer | No |
owner_id | integer | No |
parent_business_id | integer | null | No |
percentage_usage_fee | number | No |
phone | any | No |
pickup_time | any | No |
price_level | any | No |
printer_id | integer | No |
ribbon | string | No |
route | any | No |
schedule | any | No |
seo_description | any | No |
seo_image | any | No |
seo_title | any | No |
service_fee | number | Sí |
slug | string | Sí |
snooze_until | string | null | No |
state | any | No |
state_code | any | No |
street_number | any | No |
sublocality | any | No |
tax | number | Sí |
tax_id | integer | null | No |
tax_type | number | Sí |
taxes | array<integer> | No |
timezone | string | No |
types | array<integer> | No |
zipcode | any | No |
Respuestas
| Código | Descripción |
|---|---|
| 200 | Respuesta exitosa. El contenido de result varía según la operación y se devuelve como JSON. |
| 400 | Respuesta de error (error=true). Los errores de validación y de negocio comparten este código. |
| 401 | Respuesta de error: sesión ausente, inválida, o nivel de usuario fuera de los permitidos. Respuesta de error: el proyecto no existe o no tiene una suscripción activa. |
| 404 | Respuesta vacía: la versión de API solicitada no está admitida. |
| 429 | Envelope de error: se excedió un límite de consumo del proyecto (o el sujeto está baneado). Lleva Retry-After y X-RateLimit-Limit/Remaining/Reset/Scope/Key. |
| 500 | Respuesta de error: falló la búsqueda o inicialización del proyecto. |
| 503 | Envelope de error: la aplicación está temporalmente en mantenimiento. Envelope de error: el proyecto está temporalmente en mantenimiento, o los límites de consumo no se pudieron evaluar y el límite aplicable está configurado con on_error = closed (cabecera Retry-After: 1). |