Saltar al contenido principal

​
Resumen

Un Order Template es el blueprint de un tipo de order. Fija el tipo de la order (sale, purchase, transfer, invoice, return, …) y define sus reglas: el workflow que sigue una order, qué contactos y productos se permiten en ella, cómo se generan su título y slug, y qué taxonomies puede llevar. Toda order se crea desde uno. Para los tipos de order y sus efectos en inventario, consulta el overview de Commerce.

​
Dónde encontrarlo

Los order templates están en Commerce → Order Templates.

​
Properties

PropertyTipoRequeridoDescripción
titlestringSíNombre visible del template.
slugstringSíIdentificador.
typeenumSíEl tipo de order que crea este template.
descriptionstringNoDescripción opcional.
inventory_effectenumCondicionalinbound u outbound — requerido para templates de inventory adjustment.
workflows_configobjectNoLos workflow steps de la order.
contact_profilesarrayNoWhitelist de contact profiles permitidos en la order.
allowed_product_templatesarrayNoWhitelist de product templates permitidos en los line items.
allowed_child_templatesarrayNoWhitelist de child order templates que se pueden crear desde una order.
default_child_templatesarrayNoChild templates sugeridos por defecto en una order nueva.
default_price_list_slugstringNoLa price list que las orders usan por defecto para los precios de line item.
naming_conventionobjectNoEl patrón para auto-nombrar las orders.
taxonomies_idsarrayNoLas taxonomies que una order puede usar (allow-list).
default_taxonomies_idsarrayNoTaxonomies aplicadas a toda order nueva de este template.

​
Workflow

Un template puede conectar dos steps de workflow: el step inicial en el que arranca una order nueva, y el step de completado que una order debe alcanzar para marcarse como completada.

​
Whitelists

Las listas opt-in mantienen el contenido de una order dentro de límites — deja alguna vacía para sin restricción:
  • Contact profiles — solo los contactos en estos profiles se pueden poner en la order.
  • Allowed product templates — solo estos product templates pueden aparecer en los line items.
  • Allowed child templates — qué child order templates se pueden crear desde una order (se sugiere un subconjunto por defecto en cada order nueva).

​
Naming convention

Las orders nuevas obtienen su título y slug generados automáticamente desde la naming convention del template — una secuencia de segmentos:
SegmentoRenderiza
LiteralTexto fijo.
DateLa fecha actual (año, mes o día) en el timezone de commerce.
CounterUn número incremental, con ceros a la izquierda hasta un ancho mínimo.
ValueUna property o attribute del template, order, contact, organization, user o location.
El counter se reinicia según las partes de fecha del patrón — diario si incluye el día, mensual el mes, anual el año, o nunca (un counter corrido) si no hay fecha. El patrón por defecto es {título del template} - {año} - {mes} - {counter}.
El timezone usado para las fechas y los reinicios del counter se configura en Settings → Commerce → Naming timezone.

​
Taxonomies

taxonomies_ids es la allow-list de taxonomies que una order puede llevar; default_taxonomies_ids es el subconjunto aplicado a toda order nueva (siempre dentro de la allow-list).

​
Columnas de line item

Las columnas y fórmulas que se muestran en los line items de una order se definen en el product template (un content template), no aquí — un order template solo controla qué product templates se permiten.

​
Seeds

Los order templates viajan entre entornos como Seeds estructurales. Cada uno es un ítem order_templates; sus referencias (contact profiles, product templates, child templates) viajan como entradas denormalizadas { title, slug }: 
[
  {
    "object_type": "order_templates",
    "data": {
      "title": "Cumbre Retail Sale",
      "slug": "cumbre-retail-sale",
      "description": "Retail sale.",
      "type": "sale",
      "default_price_list_slug": "wholesale",
      "contact_profiles": [
        { "title": "Financial Profile", "slug": "financial-profile" }
      ],
      "allowed_product_templates": [
        { "title": "Cumbre Coffee", "slug": "cumbre-coffee", "type": "products" }
      ],
      "allowed_child_templates": [
        { "title": "Standard Purchase", "slug": "standard-purchase", "type": "purchase" }
      ],
      "naming_convention": {
        "title_segments": [
          { "type": "value", "object_type": "order_templates", "path": "title" },
          { "type": "literal", "value": " - " },
          { "type": "date", "format": "year_4" },
          { "type": "literal", "value": " - " },
          { "type": "date", "format": "month_2" },
          { "type": "literal", "value": " - " },
          { "type": "counter", "digits": 4 }
        ],
        "slug_from_title": true,
        "counter_starts_at": 1
      }
    }
  }
]

​
Gobernanza y permisos

Solo un super admin o un Master puede crear, editar y eliminar order templates.

​
Acceso por API

Los order templates tienen CRUD completo. Consulta la API reference.

​
Relacionado

Orders

Las orders creadas desde este template.

Workflows

Los steps por los que avanza una order.