> ## Documentation Index
> Fetch the complete documentation index at: https://partner-api.xenda.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Crear un pedido de prueba

> Genera un pedido en la sucursal de la key **usando tus códigos** de producto
y sabor — el mismo circuito de validación y cotización que usa el bot de
WhatsApp (precios y total los calcula Xenda contra el catálogo sincronizado).
El pedido nace `pendiente` y aparece en tu próximo poll de `GET /v1/orders`.

Herramienta de testing de integración: en producción los pedidos reales los
crea el bot a partir de la conversación con el cliente.




## OpenAPI

````yaml /openapi-pos.yaml post /v1/test/orders
openapi: 3.1.0
info:
  title: Xenda POS Bridge
  version: 1.0.0
  description: >
    Bridge entre tu sistema de punto de venta y el módulo de pedidos por
    WhatsApp de

    Xenda. Tu POS empuja el catálogo, consulta los pedidos que toma el bot e
    informa

    los cambios de estado. Todo el tráfico lo origina tu sistema; la key es por

    sucursal.
servers:
  - url: https://api.automationhub.one/api:07fkGLk_
    description: Producción (sandbox = misma URL con key de la sucursal demo)
security:
  - ApiKeyAuth: []
paths:
  /v1/test/orders:
    post:
      summary: Crear un pedido de prueba
      description: >
        Genera un pedido en la sucursal de la key **usando tus códigos** de
        producto

        y sabor — el mismo circuito de validación y cotización que usa el bot de

        WhatsApp (precios y total los calcula Xenda contra el catálogo
        sincronizado).

        El pedido nace `pendiente` y aparece en tu próximo poll de `GET
        /v1/orders`.


        Herramienta de testing de integración: en producción los pedidos reales
        los

        crea el bot a partir de la conversación con el cliente.
      operationId: createTestOrder
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TestOrderRequest'
            example:
              nombre_cliente: Cliente de prueba
              delivery_type: delivery
              calle: Av. Corrientes
              numero: '3247'
              piso_depto: 5A
              localidad: Almagro
              items:
                - codigo: '2'
                  cantidad: 1
                  sabores:
                    - '744'
                    - '731'
      responses:
        '200':
          description: Pedido creado, queda `pendiente`.
          content:
            application/json:
              schema:
                type: object
                properties:
                  order_id:
                    type: integer
                  status:
                    type: string
                  costo_envio:
                    type: number
                  total:
                    type: number
        '400':
          description: >-
            Código desconocido, sabor no disponible o reglas de opciones
            incumplidas.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          $ref: '#/components/responses/AccessDenied'
components:
  schemas:
    TestOrderRequest:
      type: object
      required:
        - items
      properties:
        nombre_cliente:
          type: string
          description: Default "Pedido de prueba".
        telefono:
          type: string
          description: Formato internacional. Default un número dummy.
        delivery_type:
          type: string
          enum:
            - pick_up
            - delivery
          default: pick_up
        calle:
          type: string
        numero:
          type: string
        piso_depto:
          type: string
        localidad:
          type: string
        referencia:
          type: string
        items:
          type: array
          items:
            type: object
            required:
              - codigo
            properties:
              codigo:
                type: string
                description: Tu código de producto.
              cantidad:
                type: integer
                default: 1
              sabores:
                type: array
                items:
                  type: string
                description: Tus códigos de sabor/opción (respeta mín/máx del producto).
    Error:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
        payload: {}
  responses:
    AccessDenied:
      description: Key inválida, inactiva o `store_id` que no corresponde a la key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            code: ERROR_CODE_ACCESS_DENIED
            message: Invalid API key.
            payload: ''
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Key por sucursal provista por Xenda (formato `xnd_...`).

````