pedidos-firma

Pedir una firma electrónica sin tener cuenta

Público, sin sesión. La firma electrónica es un producto DISTINTO del ERP: quien la pide no se registra, no necesita RUC y no pasa por la plataforma de facturación.

Rate-limit: 5 pedidos por IP cada 10 min (429), en un contador propio (rl:pedido-firma:) que NO comparte cupo con el alta de cuentas ni con el formulario de contacto.

Qué campos hacen falta lo decide tipoFirma, no el tipo de cliente: el 1 (persona natural) no lleva RUC, el 2 sí, y el 3 (representante legal) añade razón social y cargo.

Retención: las fotos de identidad y los datos del titular se borran a las 48 horas; el contacto (nombre, correo, teléfono) se conserva 180 días para poder dar seguimiento. Los dos plazos empiezan a contar al recibir el pedido, no al tramitarlo, y la purga corre cada hora para que las 48 sean ciertas.

Detrás del flag PEDIDOS_FIRMA_HABILITADO; apagado, responde 404.

Con PEDIDOS_FIRMA_CANAL=api, el titular acepta por separado la finalidad obligatoria de NewBest, aporta fecha de nacimiento, género, título y dirección del catálogo, sube todos los documentos y confirma por POST /pedidos-firma/{referencia}/enviar. Los pedidos previos en canal manual no cambian.

post/pedidos-firma

Request

  • Base URL: https://contadeo.com/api
  • URL: https://contadeo.com/api/pedidos-firma
  • Auth: none required

Request body

tipoFirma1 | 2 | 3 required

1 persona natural, 2 persona natural con RUC, 3 representante legal.

vigenciainteger required

Id del catálogo de vigencias de NewBest.

esRenovacionboolean
aceptaConsentimientoboolean required

Autorización para comunicar los datos a NewBest. Sin ella se rechaza.

aceptaFinalidadOpcionalboolean
codigoDistribuidorstring

Código del distribuidor que recomendó la firma. Opcional y SIN descuento: el importe a transferir es el mismo. Se normaliza (sin espacios ni guiones, en mayúsculas). Si viene no vacío y no corresponde a un distribuidor activo, 400 con el problema en el campo codigoDistribuidor. Con DISTRIBUIDORES_FIRMA_HABILITADO apagado se ignora.

sitiostring

Honeypot: déjalo vacío.

aceptaFinalidadObligatoriaboolean

Consentimiento separado de NewBest; debe ser true en canal API.

Example request

{
  "codigoDistribuidor": "MARIAP"
}

Response

Pedido recibido

referenciastring

Lo que la persona apunta para preguntar por su trámite.

estadostring
pvpConIvaCentavosinteger nullable

Example response

{
  "referencia": "FE-K7QM3TXA",
  "estado": "RECIBIDO"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.