---
title: "Subir un documento a un pedido de firma"
method: POST
path: "/pedidos-firma/{referencia}/documentos"
tags: ["pedidos-firma"]
---

# Subir un documento a un pedido de firma

`POST /pedidos-firma/{referencia}/documentos`

## Request

- Base URL: `https://contadeo.com/api`
- URL: `https://contadeo.com/api/pedidos-firma/{referencia}/documentos`
- Auth: none required

Público, sin sesión. Cuelga de la **referencia** que devolvió el alta, no de un id interno: obliga a haber pasado antes por `POST /pedidos-firma` y su cupo por IP. Solo admite documentos mientras el pedido está en `RECIBIDO`.

El contenido viaja en base64 dentro del JSON. **Los bytes se comprueban**: el `content-type` que declara el cliente tiene que coincidir con la firma real del fichero (JPEG, PNG, WebP o PDF). Un ejecutable o un HTML declarado como imagen se rechaza con 400. No hay antivirus: esto impide colar otro formato, no un JPEG malicioso.

Topes: 3 MB en fotos de identidad (cédula y selfie), 8 MB en el resto. Solo se aceptan los tipos de documento que pide el `tipoFirma` del pedido.

Volver a subir el mismo tipo REEMPLAZA al anterior y borra su objeto.

Las fotos se borran a las 48 horas de crearse el pedido.

## Path parameters

- `referencia` string, required

## Request body

- object
  - `tipoArchivo` integer, required: Id del catálogo de NewBest: 1 cédula frontal, 2 posterior, 3 selfie, 4 comprobante.
  - `nombre` string
  - `contentType` 'image/jpeg' | 'image/png' | 'image/webp' | 'application/pdf', required
  - `base64` string, required: El fichero en base64, sin el prefijo `data:`.

## Response `200`

Documento guardado

- object
  - `id` string, uuid
  - `tipoArchivo` integer
  - `nombre` string
  - `tamanoBytes` integer

## Other responses

- `400`: Formato no admitido, demasiado grande, o los bytes no son lo declarado
- `404`: La referencia no existe o el pedido ya no admite documentos
- `429`: Demasiadas subidas desde esa IP

---

[API](https://skmtc.dev/contadeo/apis/api-de-contadeo.md) · [All operations](https://skmtc.dev/contadeo/apis/api-de-contadeo/llms.txt) · [OpenAPI document](https://skmtc.dev/contadeo/apis/api-de-contadeo/revisions/461bbb9a74ce?raw)