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

# Subir documentación

Este endpoint permite que puedas subir documentación a una reclamación que ya ha sido creada.
La documentación que se suba debe ser un archivo en formato `JPG`, `TIFF` o `JPEG` y no debe exceder los 10MB.

<Info>
  Tenemos en el roadmap la posibilidad de subir documentación en otros formatos. Mantente atento a
  las actualizaciones de la documentación.
</Info>

## ¿Para qué se utiliza este endpoint?

Cuando un usuario ha creado una reclamación y necesita subir documentación adicional para soportar su reclamación, lo mismo para el caso de un merchant.
El usuario o merchant debe subir la documentación que soporte su reclamación, por ejemplo, una factura, un contrato, una foto, etc.

<Steps>
  <Step title="Primera presentación">
    Un usuario ha creado una reclamación y necesita subir documentación adicional para soportar su
    reclamación.
  </Step>

  <Step title="Colaboración">
    En esta etapa el merchant puede decidir si quiere colaborar o no, dando como perdido el dinero o
    peleando la reclamación. En caso de pelear la reclamación, el merchant debe subir la
    documentación que soporte su reclamación.
  </Step>

  <Step title="Continuación">
    En caso de que el merchant haya colaborado, la disputa se da por finalizada. En caso de que haya
    peleado la reclamación, se continuará con el proceso de disputa.
  </Step>
</Steps>

## ¿Cómo se utiliza este endpoint?

Vas a recibir una URL a la que debes hacer una petición `PUT` con el archivo que quieres subir.
El archivo debe ser enviado en el cuerpo de la petición. El archivo debe ser un archivo en formato `JPG`, `PNG` o `JPEG` y no debe exceder los 10MB.
La URL está firmada y tiene una validez de 1 hora, por lo que debes hacer la petición antes de que expire.
Solamente se admite 1 subida de documentación por URL generada.

<Warning>
  Si reutilizas la URL generada para subir documentación, sobre-escribirás la documentación
  previamente subida, lo que podría afectar el proceso de disputa.
</Warning>


## OpenAPI

````yaml POST /claims/{claimId}/documentation
openapi: 3.0.0
info:
  version: 4.7.6
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  title: Kausanna API
  description: >
    Bienvenido a Kausanna, el servicio ofrecido por SONQO, dedicado a procesar
    los contracargos de tus clientes en tiempo real,

    brindando una solución integral que te permite concentrarte en tu negocio
    sin preocuparte por la complejidad de las redes de

    Visa y Mastercard.


    En el mundo de los negocios, los contracargos pueden ser una preocupación
    constante para los comercios y las empresas.

    La necesidad de enfrentar disputas de pagos, desconocimientos o
    reclamaciones de clientes puede ser un desafío significativo,

    especialmente cuando se trabaja con múltiples proveedores de tarjetas y
    redes de pago.

    Es en este punto donde Kausanna se convierte en tu mejor aliado.


    Nuestra plataforma Kausanna se ha desarrollado pensando en la simplicidad y
    eficiencia,

    ofreciendo un sistema escalable y seguro que te permitirá manejar los
    contracargos de manera rápida y efectiva.

    Olvídate de la complejidad técnica y los detalles burocráticos, Kausanna se
    encarga de abstraer toda la

    complejidad de las redes de Visa y Mastercard para que puedas enfocarte en
    lo que realmente importa: hacer crecer tu negocio.


    Verificá el estado de nuestras APIs en [Kausanna
    Status](https://kausanna.instatus.com/)
  contact:
    email: ongoing-processes-sonqo@naranjax.com
  x-logo:
    url: https://www.naranjax.com/assets/images/navbar-isologo-naranjax.png
    altText: NaranjaX Logo
    backgroundColor: '#ffffff'
    href: https://www.naranjax.com/
servers:
  - url: https://e3-kausanna.sonqo.io
    description: Sandbox
  - url: https://kausanna.sonqo.io
    description: Entorno de producción
security:
  - bearerAuth: []
paths:
  /claims/{claimId}/documentation:
    post:
      tags:
        - claims > {claimId}
      summary: Subir documentación de una reclamación
      operationId: postClaimDocumentation
      parameters:
        - name: claimId
          in: path
          schema:
            type: integer
          required: true
          example: '207779219414'
      requestBody:
        $ref: '#/components/requestBodies/postClaimDocumentation.request'
      responses:
        '200':
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
                example: application/json
          content:
            application/json:
              schema:
                type: object
              example:
                success: true
                url: >-
                  https://first-presentation-document-bucket-develop.s3.us-east-1.amazonaws.com/1234567890/...
        '400':
          description: Document extension not allowed
          content:
            application/json:
              schema:
                type: object
              example:
                success: false
                expection: HttpError
                message: >-
                  File extension  not allowed. Allowed extensions: png, jpg,
                  jpeg.
                code: BAD_REQUEST
components:
  requestBodies:
    postClaimDocumentation.request:
      content:
        application/json:
          schema:
            type: object
            example:
              extension: png
            properties:
              extension:
                type: string
                example: png
                enum:
                  - png
                  - jpg
                  - jpeg
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API Token generated for your account. The token must be prefixed with
        `Bearer `.

````