Restofy Docs
Reglas de impuestos POST

Crear regla de impuesto

POST /api/tax-rules/create-tax-rule

Descripción

Crea una regla que aplica un impuesto en ciertos canales de entrega.

Detalles

* Registra una regla nueva que asocia un impuesto fijo del país a los canales de entrega indicados. * La regla se asigna luego a cada producto desde el catálogo: sin productos asignados no cobra a ninguno. * Si no se especifican canales de entrega, la regla aplica en todos los canales. * Si varias reglas podrían aplicar a la misma venta, se usa la más específica configurada. * Falla si el impuesto no existe o no está activo en el país configurado.

Permisos requeridos

admin.module

Request

Nombre Tipo Requerido Reglas
taxId int
min_value:1
name string No
max:120
channelIds string No
array_int
validFrom string
min:10 max:10
validTo string No
min:10 max:10
priority int
min_value:1 max_value:999
outputAccountId int No
min_value:1
inputAccountId int No
min_value:1

Ejemplo de request

curl -X POST https://restofy.pro/api/tax-rules/create-tax-rule \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -H "X-Tenant-Key: <tenantKey>" \
  -d '{
    "taxId": 1,
    "validFrom": "string",
    "priority": 1
}'

Los valores son demo: reemplázalos por datos reales del negocio.

Ejemplo de respuesta

Actualizado: 2026-09-08T16:35:34Z
HTTP 200

Request

{
    "taxId": 6,
    "name": "Regla update 6aa0392237d4b",
    "validFrom": "2024-01-01",
    "priority": 100
}

Response

{
    "success": true,
    "message": "Regla creada",
    "data": {
        "taxRule": {
            "id": 4,
            "taxId": 6,
            "name": "Regla update 6aa0392237d4b",
            "channelIds": [],
            "validFrom": "2024-01-01",
            "validTo": null,
            "priority": 100,
            "isActive": 1,
            "outputAccountId": null,
            "inputAccountId": null
        }
    }
}