Crear

Descripción general

Este endpoint crea una automatización recurrente con las mismas reglas que el formulario de la aplicación: un cliente, una razón social, un concepto, la periodicidad y los conceptos que se cobran en cada orden de cobro. Una solicitud exitosa devuelve 201 con la automatización creada, incluidos sus totales y su next_billing_date.

Si la primera fecha de cobro es hoy (en la zona horaria de la organización), la automatización genera la orden de cobro en ese momento: con estatus issued, fecha de emisión de hoy, vencimiento a grace_period_days días de la emisión y sin CFDI. La ejecución queda en el historial como automated, se actualiza last_execution_at y, si no quedan fechas por cobrar, la automatización pasa a completed. Si esa generación falla, la ejecución queda en el historial con estatus error y la solicitud responde 201 igualmente; puedes reintentarla.

Acepta el header Idempotency-Key para reintentar sin crear automatizaciones duplicadas (ver Idempotencia).

Requiere el permiso Crear en Automatizaciones.

Endpoint

{
  "customer_id": "cmu21fp9g00qiv1dqitkc8c8x",
  "legal_entity_id": "cmpydghmk0004v1oyioviuwjs",
  "currency": "MXN",
  "concept": "Iguala mensual",
  "start_date": "2026-11-01",
  "interval": "monthly",
  "monthly_mode": "day_of_month",
  "items": [
    {
      "product_name": "Servicio de consultoría",
      "description": "Consultoría mensual",
      "quantity": 1,
      "unit_price": "12000",
      "product_code": "84111506",
      "unit_code": "E48",
      "taxes": [
        {
          "type": "iva",
          "category": "transferred",
          "rate": "0.16"
        }
      ]
    }
  ]
}

Reglas de los campos

weekdays y monthly_mode se aceptan y se guardan con cualquier interval. No se aceptan campos adicionales: cualquier campo desconocido responde 400.

Conceptos (items[])

El total de cada concepto (subtotal menos descuento, más impuestos trasladados, menos retenidos) debe ser mayor o igual a 0.

Impuestos (items[].taxes[])

Errores

400 — reglas de la automatización

Cuando la automatización no cumple sus reglas, la API responde INVALID_AUTOMATION sin errors; message une todas las reglas que fallaron, separadas por un espacio:

• "La fecha de inicio debe ser menor a la fecha de fin"
• "Por lo menos un producto o servicio debe ser agregado."
• "Todos los productos deben incluir: cantidad y precio unitario."
• "Todos los productos deben contener un total igual o mayor a 0."
• "Al menos un día de la semana debe ser seleccionado."
• "El modo mensual debe ser seleccionado."

400 — producto no encontrado

Un product_id que no pertenece a tu organización:

{
  "code": "PRODUCT_NOT_FOUND",
  "message": "Ocurrió un error al crear la automatización, por favor intenta nuevamente más tarde o contacta a soporte si el problema persiste.",
  "request_id": "b1905913-d742-4c83-8257-4d485721520f"
}