> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Notificar entrega

> Agrega entregas a una orden para notificar a los proveedores de prevención de fraude después del pago.

Este endpoint te permite agregar varias entregas a una orden para notificar a los proveedores de prevención de fraude. Las entregas que envíes se agregarán a las que ya existen.


## OpenAPI

````yaml openapi/es/payments/notify-fulfillments.json POST /payments/{payment_id}/fulfillments
openapi: 3.1.0
info:
  title: payments
  version: 1.0.2
servers:
  - url: https://api-sandbox.y.uno/v1
    description: Sandbox
  - url: https://api.y.uno/v1
    description: Production (US)
security:
  - sec0: []
    sec1: []
paths:
  /payments/{payment_id}/fulfillments:
    post:
      summary: Notificar cumplimiento
      description: >-
        Notifica el estado del cumplimiento y los detalles de envío de una orden
        de pago.
      operationId: fulfillments
      parameters:
        - name: payment_id
          in: path
          required: true
          schema:
            type: string
          description: El identificador único del pago (MAX 64; MIN 36).
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - status
                - fulfillments
              properties:
                status:
                  type: string
                  description: El estado del cumplimiento de la orden.
                  enum:
                    - PARTIAL
                    - COMPLETED
                    - REPLACEMENT
                    - CANCELED
                fulfillments:
                  type: array
                  description: Arreglo de cumplimientos
                  items:
                    type: object
                    properties:
                      id:
                        type: string
                        description: >-
                          El identificador único del cumplimiento (MAX 255; MIN
                          3)
                      type:
                        type: string
                        description: El tipo de cumplimiento
                        enum:
                          - CUSTOM
                          - MILITARY
                          - ELECTRONIC
                          - EXPRESS
                          - STANDARD
                          - SCHEDULED
                          - ECONOMY
                          - PRIORITY
                          - SAME_DAY
                          - NEXT_DAY
                          - THIRD_DAY
                          - STORE_PICK_UP
                          - LOCKER_PICK_UP
                          - OTHER
                      status:
                        type: string
                        description: El estado del cumplimiento.
                        enum:
                          - PARTIAL
                          - COMPLETED
                          - REPLACEMENT
                          - CANCELED
                      description:
                        type: string
                        description: La descripción del cumplimiento.  (MAX 255; MIN 3)
                      carriers:
                        type: array
                        description: >-
                          Arreglo de transportistas. Envíalo en cada
                          cumplimiento: un cumplimiento sin `carriers` se
                          rechaza con 400 VALIDATION_ERROR. Se acepta un arreglo
                          vacío (`[]`).
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              description: >-
                                El identificador único del transportista (MAX
                                255; MIN 3)
                            tracking_id:
                              type: array
                              description: >-
                                Identificadores de seguimiento del transportista
                                (MAX 255; MIN 3 por elemento)
                              items:
                                type: string
                            tracking_url:
                              type: array
                              description: >-
                                URL de seguimiento del transportista (MAX 999;
                                MIN 1 por elemento)
                              items:
                                type: string
                            shipped_at:
                              type: string
                              description: >-
                                Fecha y hora de envío (RFC3339, por ejemplo
                                2024-11-20T15:00:00Z)
                              format: date-time
                            delivered_at:
                              type: string
                              description: >-
                                Fecha y hora de entrega (RFC3339, por ejemplo
                                2024-11-23T18:00:00Z)
                              format: date-time
                          required:
                            - id
                            - tracking_id
                            - tracking_url
                    required:
                      - id
                      - type
                      - status
                      - carriers
                carriers:
                  type: 'null'
                  description: 'Obsoleto: usa `fulfillments[].carriers` en su lugar'
            examples:
              Request Example:
                value:
                  status: PARTIAL
                  fulfillments:
                    - id: fulfillment-1
                      type: STANDARD
                      status: COMPLETED
                      description: Package delivered successfully.
                      carriers:
                        - id: UPS
                          tracking_id:
                            - TRK12345
                            - TRK67890
                          tracking_url:
                            - https://tracking.example.com/TRK12345
                            - https://tracking.example.com/TRK67890
                          shipped_at: '2024-11-20T15:00:00Z'
                          delivered_at: '2024-11-23T18:00:00Z'
              Empty Carriers:
                summary: Empty Carriers
                value:
                  status: PARTIAL
                  fulfillments:
                    - id: fulfillment-1
                      type: STANDARD
                      status: COMPLETED
                      description: Package delivered successfully.
                      carriers: []
      responses:
        '202':
          description: Aceptado. La respuesta no tiene cuerpo.
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Invalid Request:
                  value:
                    code: INVALID_REQUEST
                    messages:
                      - Invalid request
                  summary: Invalid Request
              schema:
                type: object
                properties: {}
      deprecated: false
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      x-default: <Your public-api-key>
      name: public-api-key
    sec1:
      type: apiKey
      in: header
      name: private-secret-key
      x-default: <Your private-secret-key>

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.