Copiar página

Errores de la API v3

Toda respuesta no-2xx es un documento RFC 9457 application/problem+json. Los clientes programan contra code (estable, append-only), nunca contra detail (inglés técnico, puede cambiar).

Estructura del error

Shape plano (sin envoltorio): 5 miembros core de RFC 9457 + extensiones de AllSign.

{
  "type": "https://allsign.io/developers/docs/errors#DOCUMENT_NOT_FOUND",
  "title": "Document not found",
  "status": 404,
  "detail": "No document exists with id doc_...",
  "instance": "/v3/documents/doc_...",
  "code": "DOCUMENT_NOT_FOUND",
  "requestId": "req_...",
  "errors": []
}

Extensiones por código

Algunos códigos agregan campos: DOCUMENT_NOT_SENDABLE trae reason; PERMISSION_DENIED trae requiredScope y yourScopes cuando falta un scope; RATE_LIMITED trae retryAfter (segundos) y el header Retry-After, salvo el del recordatorio a firmante (ver Rate limits). Cada type enlaza al ancla de su código en esta página (https://allsign.io/developers/docs/errors#<CODE>).

Un 404 nombra el recurso que no existe: DOCUMENT_NOT_FOUND, TEMPLATE_NOT_FOUND, FOLDER_NOT_FOUND… Una ruta que no existe (un typo en el path, como /v3/document/doc_…) responde RESOURCE_NOT_FOUND, así que no la confundes con un documento borrado.

Errores a nivel de campo

La validación semántica (422 VALIDATION_ERROR) puebla errors[] con un objeto por campo: field (dot/bracket), pointer (JSON Pointer), code y detail.

"errors": [
  { "field": "signers[0].email", "pointer": "/signers/0/email",
    "code": "invalid_email", "detail": "not a valid email address" }
]

Catálogo de códigos

La taxonomía completa: 84 códigos, congelada y append-only. Cada fila tiene id="<CODE>" para que el type URI ancle aquí.

Activo significa que la API lo emite hoy. Reservado (19 de 84) significa que el código forma parte del contrato pero ninguna ruta lo devuelve todavía: o el caso lo cubre otro código (un JSON malformado o un Content-Type que no es JSON salen como VALIDATION_ERROR, no como MALFORMED_JSON ni UNSUPPORTED_MEDIA_TYPE; a una key sin el scope se le responde PERMISSION_DENIED, no INSUFFICIENT_SCOPE), o espera una capacidad que aún no lanzamos (los TOKEN_* esperan OAuth), o la política de seguridad lo colapsa a propósito (una key inválida, revocada o vencida responde 401 AUTHENTICATION_REQUIRED, no API_KEY_*, para no confirmar que la key existe). Un Accept que no es JSON tampoco da NOT_ACCEPTABLE: la respuesta llega en JSON igual.

51 de 84 códigos traen su problem+json real, grabado por los tests contra sandbox: ábrelo en «Así se ve». Los demás dicen por qué no lo tienen (es un código reservado, el sandbox no cobra, hace falta una caída real…): preferimos explicarlo a inventar un ejemplo.

No programes una rama para un código reservado — sería código muerto. Un reservado nunca cambia de nombre ni de significado al activarse, así que agregarlo después es seguro; anticiparlo, no.

CódigoStatusTítuloEstado
ANNEX_OF_ANNEX_NOT_ALLOWED 409 Conflict
Así se ve · verificado

Respuesta real de sandbox a POST /v3/documents/doc_aa07ee47bbea45edb879fdc2ac9db8e7/annexes (ver la operación), backend 24c0469.

Respuesta · 409 · ANNEX_OF_ANNEX_NOT_ALLOWED
{
  "type": "https://allsign.io/developers/docs/errors#ANNEX_OF_ANNEX_NOT_ALLOWED",
  "title": "Conflict",
  "status": 409,
  "detail": "This document is itself an annex. Attach the new annex to the root document instead.",
  "instance": "/v3/documents/doc_aa07ee47bbea45edb879fdc2ac9db8e7/annexes",
  "code": "ANNEX_OF_ANNEX_NOT_ALLOWED",
  "requestId": "req_afd05ccadf4e4d4e8c22a38f25e3d8c7"
}
Activo
API_KEY_EXPIRED 401 Unauthorized

Sin ejemplo grabado. Es un código reservado: ninguna ruta lo devuelve todavía, así que no hay respuesta que grabar.

Reservado
API_KEY_INVALID 401 Unauthorized

Sin ejemplo grabado. Es un código reservado: ninguna ruta lo devuelve todavía, así que no hay respuesta que grabar.

Reservado
API_KEY_REVOKED 401 Unauthorized

Sin ejemplo grabado. Es un código reservado: ninguna ruta lo devuelve todavía, así que no hay respuesta que grabar.

Reservado
AUTHENTICATION_REQUIRED 401 Authentication required
Así se ve · verificado

Respuesta real de sandbox a GET /v3/documents (ver la operación), backend 24c0469.

Respuesta · 401 · AUTHENTICATION_REQUIRED
{
  "type": "https://allsign.io/developers/docs/errors#AUTHENTICATION_REQUIRED",
  "title": "Authentication required",
  "status": 401,
  "detail": "Provide an API key via Authorization: Bearer $ALLSIGN_API_KEY…",
  "instance": "/v3/documents",
  "code": "AUTHENTICATION_REQUIRED",
  "requestId": "req_b18d2960e68d4135ad139055bdf24f98"
}
Activo
BATCH_NOT_FOUND 404 Bulk-send batch not found
Así se ve · verificado

Respuesta real de sandbox a GET /v3/documents/bulk-sends/bat_e6282f72d60345d384d2b16cf0700624 (ver la operación), backend 24c0469.

Respuesta · 404 · BATCH_NOT_FOUND
{
  "type": "https://allsign.io/developers/docs/errors#BATCH_NOT_FOUND",
  "title": "Bulk-send batch not found",
  "status": 404,
  "detail": "No bulk-send batch was found with that id.",
  "instance": "/v3/documents/bulk-sends/bat_e6282f72d60345d384d2b16cf0700624",
  "code": "BATCH_NOT_FOUND",
  "requestId": "req_7e1406b4cbd74967a85f8b8844351fe6"
}
Activo
CATALOG_TEMPLATE_NOT_FOUND 404 Catalog template not found
Así se ve · verificado

Respuesta real de sandbox a POST /v3/templates/catalog/no-existe:copy (ver la operación), backend 24c0469.

Respuesta · 404 · CATALOG_TEMPLATE_NOT_FOUND
{
  "type": "https://allsign.io/developers/docs/errors#CATALOG_TEMPLATE_NOT_FOUND",
  "title": "Not Found",
  "status": 404,
  "detail": "No published catalog template was found with slug 'no-existe'.",
  "instance": "/v3/templates/catalog/no-existe:copy",
  "code": "CATALOG_TEMPLATE_NOT_FOUND",
  "requestId": "req_97a848684ace46d8bb72f456f96c237b"
}
Activo
CONSTANCIA_NOT_FOUND 404 Constancia not found
Así se ve · verificado

Respuesta real de sandbox a GET /v3/constancias/cst_6d09d152ab804645b8884b7e20337328 (ver la operación), backend 24c0469.

Respuesta · 404 · CONSTANCIA_NOT_FOUND
{
  "type": "https://allsign.io/developers/docs/errors#CONSTANCIA_NOT_FOUND",
  "title": "Not Found",
  "status": 404,
  "detail": "No constancia was found with that id.",
  "instance": "/v3/constancias/cst_6d09d152ab804645b8884b7e20337328",
  "code": "CONSTANCIA_NOT_FOUND",
  "requestId": "req_c8a10a1a99bb4db09e4d9b3a9f42a9ef"
}
Activo
CONTRACT_REQUIRED 403 NOM-151 contract required

Sin ejemplo grabado. Depende de lo que tenga activado tu cuenta (contrato o funciones), y la cuenta de las pruebas tiene todo encendido.

Activo
DEV_FEATURE_RESTRICTED 403 Feature restricted in this environment
Así se ve · verificado

Respuesta real de sandbox a POST /v3/documents/bulk-sends (ver la operación), backend 24c0469.

Respuesta · 403 · DEV_FEATURE_RESTRICTED
{
  "type": "https://allsign.io/developers/docs/errors#DEV_FEATURE_RESTRICTED",
  "title": "Forbidden",
  "status": 403,
  "detail": "The feature 'bulk_send' is not available with your current API key (environment: test).",
  "instance": "/v3/documents/bulk-sends",
  "code": "DEV_FEATURE_RESTRICTED",
  "requestId": "req_87e254c1249946cfbdc8516819d10deb",
  "featureRequested": "bulk_send",
  "environment": "test",
  "allowedFeatures": [
    "firma_autografa",
    "firma_simple",
    "embedded_signing"
  ],
  "allowedFeaturesDisplay": [
    "Firma Autógrafa (Wet Signature)",
    "Firma Simple (Click-to-sign)",
    "Embedded Signing Widget"
  ],
  "upgradeMessage": "This feature is only available with a production key (allsign_live_sk_…). Create a live key in your AllSign dashboard under Developers → API Keys.",
  "upgradeUrl": "https://allsign.io/pricing"
}
Activo
DOCUMENT_ALREADY_SIGNED 409 Document already signed
Así se ve · verificado

Respuesta real de sandbox a POST /v3/documents/doc_f225e42012ba44dd853a06e460b02674/save-to-template (ver la operación), backend 24c0469.

Respuesta · 409 · DOCUMENT_ALREADY_SIGNED
{
  "type": "https://allsign.io/developers/docs/errors#DOCUMENT_ALREADY_SIGNED",
  "title": "Document already signed",
  "status": 409,
  "detail": "A document with signatures already on it cannot be saved as a template.",
  "instance": "/v3/documents/doc_f225e42012ba44dd853a06e460b02674/save-to-template",
  "code": "DOCUMENT_ALREADY_SIGNED",
  "requestId": "req_6d22adad6f034dcb857a752eed5af7a9"
}
Activo
DOCUMENT_ALREADY_VOIDED 409 Conflict

Sin ejemplo grabado. Es un código reservado: ninguna ruta lo devuelve todavía, así que no hay respuesta que grabar.

Reservado
DOCUMENT_CONFLICT 409 Document conflict
Así se ve · verificado

Respuesta real de sandbox a POST /v3/documents/doc_09bf1cccce9b463691037861ca4eea6f/observers (ver la operación), backend 24c0469.

Respuesta · 409 · DOCUMENT_CONFLICT
{
  "type": "https://allsign.io/developers/docs/errors#DOCUMENT_CONFLICT",
  "title": "Conflict",
  "status": 409,
  "detail": "The document was voided; it no longer takes observers.",
  "instance": "/v3/documents/doc_09bf1cccce9b463691037861ca4eea6f/observers",
  "code": "DOCUMENT_CONFLICT",
  "requestId": "req_77042c955bec4f2b8bd00e6388216505"
}
Activo
DOCUMENT_HAS_NO_FIELDS 422 Unprocessable Entity

Sin ejemplo grabado. Es un código reservado: ninguna ruta lo devuelve todavía, así que no hay respuesta que grabar.

Reservado
DOCUMENT_NOT_EDITABLE 409 Conflict
Así se ve · verificado

Respuesta real de sandbox a POST /v3/documents/doc_19deea649a6e421585db7e09bdc1faa4/fields:from-document (ver la operación), backend 24c0469.

Respuesta · 409 · DOCUMENT_NOT_EDITABLE
{
  "type": "https://allsign.io/developers/docs/errors#DOCUMENT_NOT_EDITABLE",
  "title": "Conflict",
  "status": 409,
  "detail": "This document is already in signing; its fields can no longer be imported.",
  "instance": "/v3/documents/doc_19deea649a6e421585db7e09bdc1faa4/fields:from-document",
  "code": "DOCUMENT_NOT_EDITABLE",
  "requestId": "req_1cd7885fff374f8bb522d76be322ad0e"
}
Activo
DOCUMENT_NOT_FOUND 404 Document not found
Así se ve · verificado

Respuesta real de sandbox a GET /v3/documents/doc_9c9f2f6749794c8c8717b0fd5458f074/file (ver la operación), backend 24c0469.

Respuesta · 404 · DOCUMENT_NOT_FOUND
{
  "type": "https://allsign.io/developers/docs/errors#DOCUMENT_NOT_FOUND",
  "title": "Document not found",
  "status": 404,
  "detail": "Document not found",
  "instance": "/v3/documents/doc_9c9f2f6749794c8c8717b0fd5458f074/file",
  "code": "DOCUMENT_NOT_FOUND",
  "requestId": "req_9099fea09e7e4822a33e00dde0d7dc14"
}
Activo
DOCUMENT_NOT_FULLY_SIGNED 409 Conflict
Así se ve · verificado

Respuesta real de sandbox a POST /v3/documents/doc_78e3621115ea4fbc88605ae1c3118ec6/annexes (ver la operación), backend 24c0469.

Respuesta · 409 · DOCUMENT_NOT_FULLY_SIGNED
{
  "type": "https://allsign.io/developers/docs/errors#DOCUMENT_NOT_FULLY_SIGNED",
  "title": "Conflict",
  "status": 409,
  "detail": "Annexes can only be attached to a fully signed document. This document's current status does not allow it.",
  "instance": "/v3/documents/doc_78e3621115ea4fbc88605ae1c3118ec6/annexes",
  "code": "DOCUMENT_NOT_FULLY_SIGNED",
  "requestId": "req_3f16b52d15ec400c8cc87067adfef964"
}
Activo
DOCUMENT_NOT_SENDABLE 409 Document not sendable
Así se ve · verificado

Respuesta real de sandbox a POST /v3/documents/doc_82fa050abbc44b9587b71c8f84e8f923/send (ver la operación), backend 24c0469.

Respuesta · 409 · DOCUMENT_NOT_SENDABLE
{
  "type": "https://allsign.io/developers/docs/errors#DOCUMENT_NOT_SENDABLE",
  "title": "Conflict",
  "status": 409,
  "detail": "The document requires handwritten signatures (signatureValidation.autografa=true) but has no signature fields placed, so it cannot be sent for signing. Place at least one signature field before sending.",
  "instance": "/v3/documents/doc_82fa050abbc44b9587b71c8f84e8f923/send",
  "code": "DOCUMENT_NOT_SENDABLE",
  "requestId": "req_fdb94dfd9e8e41809ba7db813e2097e4",
  "reason": "The document requires handwritten signatures (signatureValidation.autografa=true) but has no signature fields placed, so it cannot be sent for signing. Place at least one signature field before sending."
}
Activo
DOCUMENT_PDF_LOCKED 409 Conflict

Sin ejemplo grabado. Pide un documento que se está llenando y que ya tiene una firma, un caso que las pruebas todavía no arman.

Activo
DOCUMENT_TOO_LARGE 413 Document too large
Así se ve · verificado

Respuesta real de sandbox a POST /v3/documents (ver la operación), backend 24c0469.

Respuesta · 413 · DOCUMENT_TOO_LARGE
{
  "type": "https://allsign.io/developers/docs/errors#DOCUMENT_TOO_LARGE",
  "title": "Request Entity Too Large",
  "status": 413,
  "detail": "The file (10.0 MB decoded) exceeds the 10 MB limit for source=file.",
  "instance": "/v3/documents",
  "code": "DOCUMENT_TOO_LARGE",
  "requestId": "req_96b273bd7e82482aa0d45651aeb4631c"
}
Activo
DUPLICATE_SIGNER 422 Duplicate signer
Así se ve · verificado

Respuesta real de sandbox a POST /v3/documents/doc_1dc79b7f4dd64d08ba9d3ed7a5626977/signers/sgr_ea59f1a241c543029768ecb7f38a65bb/reassign (ver la operación), backend 24c0469.

Respuesta · 422 · DUPLICATE_SIGNER
{
  "type": "https://allsign.io/developers/docs/errors#DUPLICATE_SIGNER",
  "title": "Duplicate signer",
  "status": 422,
  "detail": "Esa persona ya es firmante de este documento.",
  "instance": "/v3/documents/doc_1dc79b7f4dd64d08ba9d3ed7a5626977/signers/sgr_ea59f1a241c543029768ecb7f38a65bb/reassign",
  "code": "DUPLICATE_SIGNER",
  "requestId": "req_3851c69baf2940bf874d02b256d8021a"
}
Activo
ENVIRONMENT_MISMATCH 409 Environment mismatch

Sin ejemplo grabado. Solo pasa al cruzar entornos (una key live con un recurso de sandbox o al revés) o al llamar a la firma simulada con una key live, y las pruebas usan solo keys de sandbox.

Activo
EVENT_NOT_FOUND 404 Not Found

Sin ejemplo grabado. Es un código reservado: ninguna ruta lo devuelve todavía, así que no hay respuesta que grabar.

Reservado
EXPAND_DEPTH_EXCEEDED 400 Expand depth exceeded
Así se ve · verificado

Respuesta real de sandbox a GET /v3/documents/doc_8434c2beca964c7b959f96e5bbc4d1b3?expand=signers,fields,events,annexes (ver la operación), backend 24c0469.

Respuesta · 400 · EXPAND_DEPTH_EXCEEDED
{
  "type": "https://allsign.io/developers/docs/errors#EXPAND_DEPTH_EXCEEDED",
  "title": "Bad Request",
  "status": 400,
  "detail": "At most 3 expand paths are allowed.",
  "instance": "/v3/documents/doc_8434c2beca964c7b959f96e5bbc4d1b3",
  "code": "EXPAND_DEPTH_EXCEEDED",
  "requestId": "req_df05e47a00434d8db363f5efdbd30f97"
}
Activo
EXTERNAL_ID_CONFLICT 409 Conflict
Así se ve · verificado

Respuesta real de sandbox a POST /v3/constancias (ver la operación), backend 24c0469.

Respuesta · 409 · EXTERNAL_ID_CONFLICT
{
  "type": "https://allsign.io/developers/docs/errors#EXTERNAL_ID_CONFLICT",
  "title": "Conflict",
  "status": 409,
  "detail": "externalId 'pedido-muzi0on9' already identifies a constancia for another document (hash 1872a4d06486…). Use a different externalId, or send the same hash to retrieve the one already issued.",
  "instance": "/v3/constancias",
  "code": "EXTERNAL_ID_CONFLICT",
  "requestId": "req_0d782805b9534c43bd20d8468e9b3ce2"
}
Activo
FEATURE_NOT_AVAILABLE 403 Feature not available for this tenant

Sin ejemplo grabado. Depende de lo que tenga activado tu cuenta (contrato o funciones), y la cuenta de las pruebas tiene todo encendido.

Activo
FIELD_CONFLICT 409 Field name already taken
Así se ve · verificado

Respuesta real de sandbox a POST /v3/templates/tmpl_4a870c692ac14e2d81be7f9c134d527a/fields (ver la operación), backend 24c0469.

Respuesta · 409 · FIELD_CONFLICT
{
  "type": "https://allsign.io/developers/docs/errors#FIELD_CONFLICT",
  "title": "Conflict",
  "status": 409,
  "detail": "A field named 'nombre' already exists in this template.",
  "instance": "/v3/templates/tmpl_4a870c692ac14e2d81be7f9c134d527a/fields",
  "code": "FIELD_CONFLICT",
  "requestId": "req_c1f5a7de743a4edb8e6969784838bc7e",
  "errors": [
    {
      "field": "name",
      "code": "DUPLICATE",
      "detail": "Field name already exists."
    }
  ]
}
Activo
FIELD_NOT_FOUND 404 Field not found
Así se ve · verificado

Respuesta real de sandbox a DELETE /v3/templates/tmpl_2ef548a7f8414f9abf8e0d75ca9a71df/fields/rfc (ver la operación), backend 24c0469.

Respuesta · 404 · FIELD_NOT_FOUND
{
  "type": "https://allsign.io/developers/docs/errors#FIELD_NOT_FOUND",
  "title": "Not Found",
  "status": 404,
  "detail": "Field 'rfc' not found in this template.",
  "instance": "/v3/templates/tmpl_2ef548a7f8414f9abf8e0d75ca9a71df/fields/rfc",
  "code": "FIELD_NOT_FOUND",
  "requestId": "req_dc07200411324e03b6bbce3cca2ea6de"
}
Activo
FOLDER_NOT_EMPTY 409 Conflict
Así se ve · verificado

Respuesta real de sandbox a DELETE /v3/folders/fld_c1c3fb2ea6634f929addda83f073a00c (ver la operación), backend 24c0469.

Respuesta · 409 · FOLDER_NOT_EMPTY
{
  "type": "https://allsign.io/developers/docs/errors#FOLDER_NOT_EMPTY",
  "title": "Conflict",
  "status": 409,
  "detail": "Folder has documents. Move or delete them before deleting the folder.",
  "instance": "/v3/folders/fld_c1c3fb2ea6634f929addda83f073a00c",
  "code": "FOLDER_NOT_EMPTY",
  "requestId": "req_0f54ba0e06d645f9adae72d71abadcc9"
}
Activo
FOLDER_NOT_FOUND 404 Folder not found
Así se ve · verificado

Respuesta real de sandbox a GET /v3/folders/fld_c1c3fb2ea6634f929addda83f073a00c (ver la operación), backend 24c0469.

Respuesta · 404 · FOLDER_NOT_FOUND
{
  "type": "https://allsign.io/developers/docs/errors#FOLDER_NOT_FOUND",
  "title": "Folder not found",
  "status": 404,
  "detail": "No folder was found with that id.",
  "instance": "/v3/folders/fld_c1c3fb2ea6634f929addda83f073a00c",
  "code": "FOLDER_NOT_FOUND",
  "requestId": "req_8014888fbbde44e0845518524e2aee04"
}
Activo
IDEMPOTENCY_KEY_IN_PROGRESS 409 Idempotency key in progress
Así se ve · verificado

Respuesta real de sandbox a POST /v3/documents (ver la operación), backend 24c0469.

Respuesta · 409 · IDEMPOTENCY_KEY_IN_PROGRESS
{
  "type": "https://allsign.io/developers/docs/errors#IDEMPOTENCY_KEY_IN_PROGRESS",
  "title": "Conflict",
  "status": 409,
  "detail": "A request with this Idempotency-Key is still in progress.",
  "instance": "/v3/documents",
  "code": "IDEMPOTENCY_KEY_IN_PROGRESS",
  "requestId": "req_2e344a0ea69a46418d8a96c1de58ba64",
  "retryAfter": 2
}
Activo
IDEMPOTENCY_KEY_INVALID 400 Idempotency key invalid
Así se ve · verificado

Respuesta real de sandbox a POST /v3/documents (ver la operación), backend 24c0469.

Respuesta · 400 · IDEMPOTENCY_KEY_INVALID
{
  "type": "https://allsign.io/developers/docs/errors#IDEMPOTENCY_KEY_INVALID",
  "title": "Bad Request",
  "status": 400,
  "detail": "Idempotency-Key must be a UUID v4.",
  "instance": "/v3/documents",
  "code": "IDEMPOTENCY_KEY_INVALID",
  "requestId": "req_e289ae908d284f7bbbdfc6abc2178d32"
}
Activo
IDEMPOTENCY_KEY_REQUIRED 400 Idempotency key required
Así se ve · verificado

Respuesta real de sandbox a POST /v3/documents (ver la operación), backend 24c0469.

Respuesta · 400 · IDEMPOTENCY_KEY_REQUIRED
{
  "type": "https://allsign.io/developers/docs/errors#IDEMPOTENCY_KEY_REQUIRED",
  "title": "Bad Request",
  "status": 400,
  "detail": "POST requests that create or charge require a unique Idempotency-Key (UUID v4).",
  "instance": "/v3/documents",
  "code": "IDEMPOTENCY_KEY_REQUIRED",
  "requestId": "req_48ab6b50c363414c8d0e41850d05d5f5"
}
Activo
IDEMPOTENCY_KEY_REUSED 409 Idempotency key reused
Así se ve · verificado

Respuesta real de sandbox a POST /v3/documents (ver la operación), backend 24c0469.

Respuesta · 409 · IDEMPOTENCY_KEY_REUSED
{
  "type": "https://allsign.io/developers/docs/errors#IDEMPOTENCY_KEY_REUSED",
  "title": "Idempotency key reused",
  "status": 409,
  "detail": "This Idempotency-Key was already used with a different request.",
  "instance": "/v3/documents",
  "code": "IDEMPOTENCY_KEY_REUSED",
  "requestId": "req_7a71eb8164e14a01a6760499df342f6f"
}
Activo
INSUFFICIENT_CREDITS 402 Insufficient credits

Sin ejemplo grabado. El sandbox no cobra, así que nunca se queda sin créditos.

Activo
INSUFFICIENT_SCOPE 403 Forbidden

Sin ejemplo grabado. Es un código reservado: ninguna ruta lo devuelve todavía, así que no hay respuesta que grabar.

Reservado
INTERNAL_ERROR 500 Internal server error

Sin ejemplo grabado. Solo sale con una falla real del servicio, y no la provocamos para grabarla.

Activo
INVALID_CURSOR 400 Invalid cursor
Así se ve · verificado

Respuesta real de sandbox a GET /v3/documents?startingAfter=pagina-2 (ver la operación), backend 24c0469.

Respuesta · 400 · INVALID_CURSOR
{
  "type": "https://allsign.io/developers/docs/errors#INVALID_CURSOR",
  "title": "Bad Request",
  "status": 400,
  "detail": "The pagination cursor is malformed.",
  "instance": "/v3/documents",
  "code": "INVALID_CURSOR",
  "requestId": "req_631464956abd4a51be5d9580e50e14b8"
}
Activo
INVALID_EXPAND 400 Invalid expand path
Así se ve · verificado

Respuesta real de sandbox a GET /v3/documents/doc_8434c2beca964c7b959f96e5bbc4d1b3?expand=firmantes (ver la operación), backend 24c0469.

Respuesta · 400 · INVALID_EXPAND
{
  "type": "https://allsign.io/developers/docs/errors#INVALID_EXPAND",
  "title": "Bad Request",
  "status": 400,
  "detail": "Unknown expand path(s): firmantes.",
  "instance": "/v3/documents/doc_8434c2beca964c7b959f96e5bbc4d1b3",
  "code": "INVALID_EXPAND",
  "requestId": "req_2042308d311a44c693926d1a9b56dea3"
}
Activo
INVALID_FILTER 400 Bad Request

Sin ejemplo grabado. Es un código reservado: ninguna ruta lo devuelve todavía, así que no hay respuesta que grabar.

Reservado
INVALID_ID 400 Malformed identifier
Así se ve · verificado

Respuesta real de sandbox a GET /v3/documents/doc_123/evidence (ver la operación), backend 24c0469.

Respuesta · 400 · INVALID_ID
{
  "type": "https://allsign.io/developers/docs/errors#INVALID_ID",
  "title": "Malformed identifier",
  "status": 400,
  "detail": "Invalid document id.",
  "instance": "/v3/documents/doc_123/evidence",
  "code": "INVALID_ID",
  "requestId": "req_8a1bc74e22d945a6ad9358d2f8b27ec2"
}
Activo
INVALID_SORT 400 Bad Request

Sin ejemplo grabado. Es un código reservado: ninguna ruta lo devuelve todavía, así que no hay respuesta que grabar.

Reservado
INVALID_STATE_TRANSITION 409 Conflict
Así se ve · verificado

Respuesta real de sandbox a POST /v3/documents/doc_ca783e90f0444172a7fbe75400ab5ebc/signers/sgr_f70f3376d8fc450a97111874e086f6b6/remind (ver la operación), backend 24c0469.

Respuesta · 409 · INVALID_STATE_TRANSITION
{
  "type": "https://allsign.io/developers/docs/errors#INVALID_STATE_TRANSITION",
  "title": "Conflict",
  "status": 409,
  "detail": "Document is in terminal state 'ANULADO' — cannot remind.",
  "instance": "/v3/documents/doc_ca783e90f0444172a7fbe75400ab5ebc/signers/sgr_f70f3376d8fc450a97111874e086f6b6/remind",
  "code": "INVALID_STATE_TRANSITION",
  "requestId": "req_18baf385999e4893975db73d70c38511",
  "reason": "document_terminal"
}
Activo
IP_NOT_ALLOWED 403 IP address not allowed

Sin ejemplo grabado. Depende de las IPs permitidas que configures en tu key, y la key de las pruebas no limita IPs.

Activo
LIMIT_OUT_OF_RANGE 400 Bad Request

Sin ejemplo grabado. Es un código reservado: ninguna ruta lo devuelve todavía, así que no hay respuesta que grabar.

Reservado
MALFORMED_JSON 400 Bad Request

Sin ejemplo grabado. Es un código reservado: ninguna ruta lo devuelve todavía, así que no hay respuesta que grabar.

Reservado
METHOD_NOT_ALLOWED 405 Method Not Allowed
Así se ve · verificado

Respuesta real de sandbox a PUT /v3/documents, una petición que el contrato no define, backend 24c0469.

Respuesta · 405 · METHOD_NOT_ALLOWED
{
  "type": "https://allsign.io/developers/docs/errors#METHOD_NOT_ALLOWED",
  "title": "Method Not Allowed",
  "status": 405,
  "detail": "Method Not Allowed",
  "instance": "/v3/documents",
  "code": "METHOD_NOT_ALLOWED",
  "requestId": "req_d9780cacad2345e8859a2ada12147116"
}
Activo
NOT_ACCEPTABLE 406 Not Acceptable

Sin ejemplo grabado. Es un código reservado: ninguna ruta lo devuelve todavía, así que no hay respuesta que grabar.

Reservado
NOT_YOUR_TURN 409 Not this signer's turn yet
Así se ve · verificado

Respuesta real de sandbox a POST /v3/documents/doc_cb8538f977be47d597896fd6a71f8f17/signers/sgr_0dcad5b836254b2791fab1bb6e6995f2/remind (ver la operación), backend 24c0469.

Respuesta · 409 · NOT_YOUR_TURN
{
  "type": "https://allsign.io/developers/docs/errors#NOT_YOUR_TURN",
  "title": "Conflict",
  "status": 409,
  "detail": "Signer belongs to stage 3 and stage 1 has not finished — nothing to remind yet.",
  "instance": "/v3/documents/doc_cb8538f977be47d597896fd6a71f8f17/signers/sgr_0dcad5b836254b2791fab1bb6e6995f2/remind",
  "code": "NOT_YOUR_TURN",
  "requestId": "req_fda92aa97e3743a9805cbc1eaee1292c",
  "reason": "not_your_turn"
}
Activo
OAUTH_NOT_ENABLED 401 Unauthorized

Sin ejemplo grabado. Es un código reservado: ninguna ruta lo devuelve todavía, así que no hay respuesta que grabar.

Reservado
OAUTH_NOT_IMPLEMENTED 501 Not Implemented

Sin ejemplo grabado. Solo sale donde OAuth está apagado, y en el entorno de las pruebas está encendido.

Activo
OBSERVER_IS_SIGNER 409 Observer already signs
Así se ve · verificado

Respuesta real de sandbox a POST /v3/documents/doc_5dbd1cc097404878a5668c6a00774830/observers (ver la operación), backend 24c0469.

Respuesta · 409 · OBSERVER_IS_SIGNER
{
  "type": "https://allsign.io/developers/docs/errors#OBSERVER_IS_SIGNER",
  "title": "Conflict",
  "status": 409,
  "detail": "ana@ejemplo.com already signs this document; a signer cannot also be an observer.",
  "instance": "/v3/documents/doc_5dbd1cc097404878a5668c6a00774830/observers",
  "code": "OBSERVER_IS_SIGNER",
  "requestId": "req_68de996d2d6442b981652319043cc610"
}
Activo
OBSERVER_NOT_FOUND 404 Observer not found
Así se ve · verificado

Respuesta real de sandbox a DELETE /v3/documents/doc_5dbd1cc097404878a5668c6a00774830/observers/rol_245aa9e7229547b5b3e5cf30afe54094 (ver la operación), backend 24c0469.

Respuesta · 404 · OBSERVER_NOT_FOUND
{
  "type": "https://allsign.io/developers/docs/errors#OBSERVER_NOT_FOUND",
  "title": "Not Found",
  "status": 404,
  "detail": "Observer not found in this document. Organization observers are removed from Settings → Observers.",
  "instance": "/v3/documents/doc_5dbd1cc097404878a5668c6a00774830/observers/rol_245aa9e7229547b5b3e5cf30afe54094",
  "code": "OBSERVER_NOT_FOUND",
  "requestId": "req_22602288f4704ad2857ebd2b3dfa1468"
}
Activo
PAYLOAD_TOO_LARGE 413 Request Entity Too Large

Sin ejemplo grabado. Es un código reservado: ninguna ruta lo devuelve todavía, así que no hay respuesta que grabar.

Reservado
PDF_ALREADY_SIGNED 422 PDF already signed
Así se ve · verificado

Respuesta real de sandbox a POST /v3/templates (ver la operación), backend 24c0469.

Respuesta · 422 · PDF_ALREADY_SIGNED
{
  "type": "https://allsign.io/developers/docs/errors#PDF_ALREADY_SIGNED",
  "title": "PDF already signed",
  "status": 422,
  "detail": "This PDF already carries a digital signature, and editing it would invalidate it. Upload the unsigned version or a flat PDF.",
  "instance": "/v3/templates",
  "code": "PDF_ALREADY_SIGNED",
  "requestId": "req_7ce35e2fb6a24801a7f2dcd25b07db59"
}
Activo
PERMISSION_DENIED 403 Permission denied
Así se ve · verificado

Respuesta real de sandbox a POST /v3/signing-sessions/ses_ee38d79b09ad45b9ad094034c1910ecc/init (ver la operación), backend 24c0469.

Respuesta · 403 · PERMISSION_DENIED
{
  "type": "https://allsign.io/developers/docs/errors#PERMISSION_DENIED",
  "title": "Permission denied",
  "status": 403,
  "detail": "The origin 'https://otro.ejemplo.com' is not authorized to embed this session.",
  "instance": "/v3/signing-sessions/ses_ee38d79b09ad45b9ad094034c1910ecc/init",
  "code": "PERMISSION_DENIED",
  "requestId": "req_beaface9931b45e4a4eb9e51c8b13f9c"
}
Activo
PLAN_REQUIRED 403 Plan does not include this template

Sin ejemplo grabado. Solo sale al copiar una plantilla del catálogo cuando AllSign enciende el control por plan, y hoy está apagado para todas las cuentas.

Activo
PREVIEW_UNAVAILABLE 404 Preview unavailable
Así se ve · verificado

Respuesta real de sandbox a GET /v3/templates/tmpl_2a1bc982e2f04c979ff8d8c2a6468539/preview (ver la operación), backend 24c0469.

Respuesta · 404 · PREVIEW_UNAVAILABLE
{
  "type": "https://allsign.io/developers/docs/errors#PREVIEW_UNAVAILABLE",
  "title": "Not Found",
  "status": 404,
  "detail": "This template has no renderable page image.",
  "instance": "/v3/templates/tmpl_2a1bc982e2f04c979ff8d8c2a6468539/preview",
  "code": "PREVIEW_UNAVAILABLE",
  "requestId": "req_b9de17df65f64abb9601e36d7b31625a"
}
Activo
QUOTA_EXCEEDED 429 Too Many Requests

Sin ejemplo grabado. Es un código reservado: ninguna ruta lo devuelve todavía, así que no hay respuesta que grabar.

Reservado
RATE_LIMITED 429 Rate limited

Sin ejemplo grabado. Provocarlo a propósito frenaría a las demás pruebas que comparten la cuenta de sandbox.

Activo
RECIPIENT_NOT_SIGNER 422 Recipient is not a signer
Así se ve · verificado

Respuesta real de sandbox a POST /v3/documents/doc_966231febee54daeb77ff684f988b07b/send (ver la operación), backend 24c0469.

Respuesta · 422 · RECIPIENT_NOT_SIGNER
{
  "type": "https://allsign.io/developers/docs/errors#RECIPIENT_NOT_SIGNER",
  "title": "Unprocessable Entity",
  "status": 422,
  "detail": "These recipients are not signers of this document: maria@ejemplo.com. Attach signers with `signers[]` when you create the document.",
  "instance": "/v3/documents/doc_966231febee54daeb77ff684f988b07b/send",
  "code": "RECIPIENT_NOT_SIGNER",
  "requestId": "req_381f6083e0434eebb1fba906d993129d",
  "errors": [
    {
      "field": "recipients[0].email",
      "code": "NOT_A_SIGNER",
      "detail": "maria@ejemplo.com is not a signer of this document."
    }
  ]
}
Activo
RESOURCE_NOT_FOUND 404 Resource not found
Así se ve · verificado

Respuesta real de sandbox a POST /v3/signing-sessions (ver la operación), backend 24c0469.

Respuesta · 404 · RESOURCE_NOT_FOUND
{
  "type": "https://allsign.io/developers/docs/errors#RESOURCE_NOT_FOUND",
  "title": "Not Found",
  "status": 404,
  "detail": "No participant with email nadie@ejemplo.com on document c2af0193-88b8-4767-be86-e9bc40106542",
  "instance": "/v3/signing-sessions",
  "code": "RESOURCE_NOT_FOUND",
  "requestId": "req_243a82a23c1a45aba4757d8ed3758d31"
}
Activo
ROLE_NOT_FOUND 404 Role not found
Así se ve · verificado

Respuesta real de sandbox a DELETE /v3/documents/doc_d60c6183f829411b8d033f2fc4c9477d/roles/rol_1d2abe482f0045a8b0fc16c94d49005f (ver la operación), backend 24c0469.

Respuesta · 404 · ROLE_NOT_FOUND
{
  "type": "https://allsign.io/developers/docs/errors#ROLE_NOT_FOUND",
  "title": "Not Found",
  "status": 404,
  "detail": "Role not found in this document.",
  "instance": "/v3/documents/doc_d60c6183f829411b8d033f2fc4c9477d/roles/rol_1d2abe482f0045a8b0fc16c94d49005f",
  "code": "ROLE_NOT_FOUND",
  "requestId": "req_6724d101e4b248a7bd87d2f7ffd6e6ac"
}
Activo
ROLE_OCCUPIED 409 Role is held by a signer
Así se ve · verificado

Respuesta real de sandbox a DELETE /v3/documents/doc_d60c6183f829411b8d033f2fc4c9477d/roles/rol_00823ecb9d294d13869402400226758e (ver la operación), backend 24c0469.

Respuesta · 409 · ROLE_OCCUPIED
{
  "type": "https://allsign.io/developers/docs/errors#ROLE_OCCUPIED",
  "title": "Conflict",
  "status": 409,
  "detail": "Role 'Arrendador' is held by a signer. Remove the signer first, then delete the role.",
  "instance": "/v3/documents/doc_d60c6183f829411b8d033f2fc4c9477d/roles/rol_00823ecb9d294d13869402400226758e",
  "code": "ROLE_OCCUPIED",
  "requestId": "req_8704c255f6cf49999ae7d48dfa1ace21"
}
Activo
SEGURIDATA_UNAVAILABLE 503 Constancia provider unavailable

Sin ejemplo grabado. Solo sale con una falla real del servicio, y no la provocamos para grabarla.

Activo
SEQUENTIAL_NOT_AVAILABLE 403 Signing order not available

Sin ejemplo grabado. Depende de lo que tenga activado tu cuenta (contrato o funciones), y la cuenta de las pruebas tiene todo encendido.

Activo
SERVICE_UNAVAILABLE 503 Service Unavailable

Sin ejemplo grabado. Solo sale con una falla real del servicio, y no la provocamos para grabarla.

Activo
SIGNER_INVALID 422 Signer invalid
Así se ve · verificado

Respuesta real de sandbox a POST /v3/documents/doc_1dc79b7f4dd64d08ba9d3ed7a5626977/signers/sgr_ea59f1a241c543029768ecb7f38a65bb/reassign (ver la operación), backend 24c0469.

Respuesta · 422 · SIGNER_INVALID
{
  "type": "https://allsign.io/developers/docs/errors#SIGNER_INVALID",
  "title": "Signer invalid",
  "status": 422,
  "detail": "Es la misma persona; no hay nada que reasignar.",
  "instance": "/v3/documents/doc_1dc79b7f4dd64d08ba9d3ed7a5626977/signers/sgr_ea59f1a241c543029768ecb7f38a65bb/reassign",
  "code": "SIGNER_INVALID",
  "requestId": "req_922f9a91fb0c491495d387fe0f98bc12",
  "reason": "same_person"
}
Activo
SIGNER_NOT_FOUND 404 Not Found
Así se ve · verificado

Respuesta real de sandbox a POST /v3/documents/doc_ca783e90f0444172a7fbe75400ab5ebc/signers/sgr_8bc0129ec73d4d49b5d2c0335a209b8d/remind (ver la operación), backend 24c0469.

Respuesta · 404 · SIGNER_NOT_FOUND
{
  "type": "https://allsign.io/developers/docs/errors#SIGNER_NOT_FOUND",
  "title": "Not Found",
  "status": 404,
  "detail": "Signer '8bc0129e-c73d-4d49-b5d2-c0335a209b8d' not found in this document.",
  "instance": "/v3/documents/doc_ca783e90f0444172a7fbe75400ab5ebc/signers/sgr_8bc0129ec73d4d49b5d2c0335a209b8d/remind",
  "code": "SIGNER_NOT_FOUND",
  "requestId": "req_aa688e8a2b7e46ab88bb8e67a281ba61"
}
Activo
SIGNING_ORDER_INCOMPLETE 422 Signing order incomplete
Así se ve · verificado

Respuesta real de sandbox a POST /v3/documents/doc_2d02df9682eb4daa89e1dcf73635d684/send (ver la operación), backend 24c0469.

Respuesta · 422 · SIGNING_ORDER_INCOMPLETE
{
  "type": "https://allsign.io/developers/docs/errors#SIGNING_ORDER_INCOMPLETE",
  "title": "Unprocessable Entity",
  "status": 422,
  "detail": "Every signer is in the same stage, so signing in order would behave exactly like signing all at once. Use signingOrder 'parallel' or spread the signers across different stages.",
  "instance": "/v3/documents/doc_2d02df9682eb4daa89e1dcf73635d684/send",
  "code": "SIGNING_ORDER_INCOMPLETE",
  "requestId": "req_977bab702af14b0790961d843440acd6",
  "problems": [
    "Every signer is in the same stage, so signing in order would behave exactly like signing all at once. Use signingOrder 'parallel' or spread the signers across different stages."
  ],
  "reason": "single_stage"
}
Activo
TEMPLATE_ENDPOINT_REQUIRED 422 Template endpoint required
Así se ve · verificado

Respuesta real de sandbox a POST /v3/documents (ver la operación), backend 24c0469.

Respuesta · 422 · TEMPLATE_ENDPOINT_REQUIRED
{
  "type": "https://allsign.io/developers/docs/errors#TEMPLATE_ENDPOINT_REQUIRED",
  "title": "Template endpoint required",
  "status": 422,
  "detail": "Esta plantilla firma en orden y esta ruta no aplica su orden de firma: el documento nacería con todos los firmantes a la vez. Créalo con POST /v3/templates/tmpl_30cc50acf8d447c285146e8992ba3dc4/documents. No se creó ningún documento.",
  "instance": "/v3/documents",
  "code": "TEMPLATE_ENDPOINT_REQUIRED",
  "requestId": "req_9e0b14b183204b34b6c451acc11c8f23",
  "templateId": "tmpl_30cc50acf8d447c285146e8992ba3dc4"
}
Activo
TEMPLATE_IN_USE 409 Template in use
Así se ve · verificado

Respuesta real de sandbox a DELETE /v3/templates/tmpl_2a1bc982e2f04c979ff8d8c2a6468539 (ver la operación), backend 24c0469.

Respuesta · 409 · TEMPLATE_IN_USE
{
  "type": "https://allsign.io/developers/docs/errors#TEMPLATE_IN_USE",
  "title": "Conflict",
  "status": 409,
  "detail": "Template 2a1bc982-e2f0-4c97-9ff8-d8c2a6468539 is in use by 1 document(s) and 0 chain(s). Archive or complete them before deleting.",
  "instance": "/v3/templates/tmpl_2a1bc982e2f04c979ff8d8c2a6468539",
  "code": "TEMPLATE_IN_USE",
  "requestId": "req_b63edfb7b1c9427f8ea3e6ac34f145b3"
}
Activo
TEMPLATE_NOT_FOUND 404 Template not found
Así se ve · verificado

Respuesta real de sandbox a POST /v3/documents (ver la operación), backend 24c0469.

Respuesta · 404 · TEMPLATE_NOT_FOUND
{
  "type": "https://allsign.io/developers/docs/errors#TEMPLATE_NOT_FOUND",
  "title": "Template not found",
  "status": 404,
  "detail": "Template not found or has been deleted.",
  "instance": "/v3/documents",
  "code": "TEMPLATE_NOT_FOUND",
  "requestId": "req_252364b6627a443285dda69be2eb4213"
}
Activo
TOKEN_AUDIENCE_MISMATCH 403 Forbidden

Sin ejemplo grabado. Es un código reservado: ninguna ruta lo devuelve todavía, así que no hay respuesta que grabar.

Reservado
TOKEN_EXPIRED 401 Unauthorized

Sin ejemplo grabado. Es un código reservado: ninguna ruta lo devuelve todavía, así que no hay respuesta que grabar.

Reservado
TOKEN_INVALID 401 Unauthorized

Sin ejemplo grabado. Es un código reservado: ninguna ruta lo devuelve todavía, así que no hay respuesta que grabar.

Reservado
UNKNOWN_EVENT_TYPE 422 Unknown event type
Así se ve · verificado

Respuesta real de sandbox a POST /v3/webhooks (ver la operación), backend 24c0469.

Respuesta · 422 · UNKNOWN_EVENT_TYPE
{
  "type": "https://allsign.io/developers/docs/errors#UNKNOWN_EVENT_TYPE",
  "title": "Unprocessable Entity",
  "status": 422,
  "detail": "One or more event types are not in the v3 catalog.",
  "instance": "/v3/webhooks",
  "code": "UNKNOWN_EVENT_TYPE",
  "requestId": "req_45571c3852cb4ac6bae34f64dc886a28",
  "errors": [
    {
      "field": "events[0]",
      "code": "UNKNOWN_EVENT_TYPE",
      "detail": "'documento.firmado' is not a valid v3 event type."
    }
  ]
}
Activo
UNSUPPORTED_API_VERSION 400 Unsupported API version
Así se ve · verificado

Respuesta real de sandbox a GET /v3/documents (ver la operación), backend 24c0469.

Respuesta · 400 · UNSUPPORTED_API_VERSION
{
  "type": "https://allsign.io/developers/docs/errors#UNSUPPORTED_API_VERSION",
  "title": "Unsupported API version",
  "status": 400,
  "detail": "Unknown AllSign-Version '2020-01-01'. Supported: 2026-07-11.",
  "instance": "/v3/documents",
  "code": "UNSUPPORTED_API_VERSION",
  "requestId": "req_bef341c69ac84957ad49e9fc8f4f5a4d"
}
Activo
UNSUPPORTED_FORM_XFA 422 Unsupported XFA form
Así se ve · verificado

Respuesta real de sandbox a POST /v3/templates (ver la operación), backend 24c0469.

Respuesta · 422 · UNSUPPORTED_FORM_XFA
{
  "type": "https://allsign.io/developers/docs/errors#UNSUPPORTED_FORM_XFA",
  "title": "Unsupported XFA form",
  "status": 422,
  "detail": "This PDF uses an XFA (LiveCycle) form, which is not supported. Export it as a standard AcroForm PDF and try again.",
  "instance": "/v3/templates",
  "code": "UNSUPPORTED_FORM_XFA",
  "requestId": "req_fdd1b0f5006646e5a3a2894a39851d3f"
}
Activo
UNSUPPORTED_MEDIA_TYPE 415 Unsupported Media Type

Sin ejemplo grabado. Es un código reservado: ninguna ruta lo devuelve todavía, así que no hay respuesta que grabar.

Reservado
VALIDATION_ERROR 422 Validation failed
Así se ve · verificado

Respuesta real de sandbox a POST /v3/documents (ver la operación), backend 24c0469.

Respuesta · 422 · VALIDATION_ERROR
{
  "type": "https://allsign.io/developers/docs/errors#VALIDATION_ERROR",
  "title": "Validation failed",
  "status": 422,
  "detail": "The values are not valid. Fix the fields listed in `errors`. You can test a set of values for free with POST /v3/templates/{id}/validate-values.",
  "instance": "/v3/documents",
  "code": "VALIDATION_ERROR",
  "requestId": "req_71750d833b65413ea2c9794e81405461",
  "errors": [
    {
      "field": "templateValues.ciudad_celebracion",
      "code": "MISSING_REQUIRED_VARIABLE",
      "detail": "This required variable is missing. Send it with a non-empty value."
    },
    {
      "field": "templateValues.fecha_celebracion",
      "code": "MISSING_REQUIRED_VARIABLE",
      "detail": "This required variable is missing. Send it with a non-empty value."
    },
    {
      "field": "templateValues.folio_acuerdo",
      "code": "MISSING_REQUIRED_VARIABLE",
      "detail": "This required variable is missing. Send it with a non-empty value."
    },
    {
      "field": "templateValues.jurisdiccion",
      "code": "MISSING_REQUIRED_VARIABLE",
      "detail": "This required variable is missing. Send it with a non-empty value."
    },
    {
      "field": "templateValues.monto_pena",
      "code": "MISSING_REQUIRED_VARIABLE",
      "detail": "This required variable is missing. Send it with a non-empty value."
    },
    {
      "field": "templateValues.monto_pena_letra",
      "code": "MISSING_REQUIRED_VARIABLE",
      "detail": "This required variable is missing. Send it with a non-empty value."
    },
    {
      "field": "templateValues.objeto_relacion",
      "code": "MISSING_REQUIRED_VARIABLE",
      "detail": "This required variable is missing. Send it with a non-empty value."
    },
    {
      "field": "templateValues.parte_a__domicilio",
      "code": "MISSING_REQUIRED_VARIABLE",
      "detail": "This required variable is missing. Send it with a non-empty value."
    },
    {
      "field": "templateValues.parte_a__email",
      "code": "MISSING_REQUIRED_VARIABLE",
      "detail": "This required variable is missing. Send it with a non-empty value."
    },
    {
      "field": "templateValues.parte_a__representante",
      "code": "MISSING_REQUIRED_VARIABLE",
      "detail": "This required variable is missing. Send it with a non-empty value."
    },
    {
      "field": "templateValues.parte_a__rfc",
      "code": "MISSING_REQUIRED_VARIABLE",
      "detail": "This required variable is missing. Send it with a non-empty value."
    },
    {
      "field": "templateValues.parte_a__telefono",
      "code": "MISSING_REQUIRED_VARIABLE",
      "detail": "This required variable is missing. Send it with a non-empty value."
    },
    {
      "field": "templateValues.parte_b__domicilio",
      "code": "MISSING_REQUIRED_VARIABLE",
      "detail": "This required variable is missing. Send it with a non-empty value."
    },
    {
      "field": "templateValues.parte_b__email",
      "code": "MISSING_REQUIRED_VARIABLE",
      "detail": "This required variable is missing. Send it with a non-empty value."
    },
    {
      "field": "templateValues.parte_b__nombre",
      "code": "MISSING_REQUIRED_VARIABLE",
      "detail": "This required variable is missing. Send it with a non-empty value."
    },
    {
      "field": "templateValues.parte_b__representante",
      "code": "MISSING_REQUIRED_VARIABLE",
      "detail": "This required variable is missing. Send it with a non-empty value."
    },
    {
      "field": "templateValues.parte_b__rfc",
      "code": "MISSING_REQUIRED_VARIABLE",
      "detail": "This required variable is missing. Send it with a non-empty value."
    },
    {
      "field": "templateValues.parte_b__telefono",
      "code": "MISSING_REQUIRED_VARIABLE",
      "detail": "This required variable is missing. Send it with a non-empty value."
    },
    {
      "field": "templateValues.tipo_informacion_confidencial",
      "code": "MISSING_REQUIRED_VARIABLE",
      "detail": "This required variable is missing. Send it with a non-empty value."
    },
    {
      "field": "templateValues.vigencia",
      "code": "MISSING_REQUIRED_VARIABLE",
      "detail": "This required variable is missing. Send it with a non-empty value."
    },
    {
      "field": "templateValues.vigencia_post_terminacion",
      "code": "MISSING_REQUIRED_VARIABLE",
      "detail": "This required variable is missing. Send it with a non-empty value."
    }
  ]
}
Activo
WEBHOOK_LIMIT_EXCEEDED 409 Conflict

Sin ejemplo grabado. Provocarlo a propósito frenaría a las demás pruebas que comparten la cuenta de sandbox.

Activo
WEBHOOK_NOT_FOUND 404 Webhook endpoint not found
Así se ve · verificado

Respuesta real de sandbox a GET /v3/webhooks/whe_54c1d95de8c64a369095bc044665b5b3 (ver la operación), backend 24c0469.

Respuesta · 404 · WEBHOOK_NOT_FOUND
{
  "type": "https://allsign.io/developers/docs/errors#WEBHOOK_NOT_FOUND",
  "title": "Not Found",
  "status": 404,
  "detail": "No webhook endpoint was found with that id.",
  "instance": "/v3/webhooks/whe_54c1d95de8c64a369095bc044665b5b3",
  "code": "WEBHOOK_NOT_FOUND",
  "requestId": "req_e424fdd005fc4298b0231312f2126597"
}
Activo
WEBHOOK_URL_INVALID 422 Webhook URL invalid
Así se ve · verificado

Respuesta real de sandbox a POST /v3/webhooks (ver la operación), backend 24c0469.

Respuesta · 422 · WEBHOOK_URL_INVALID
{
  "type": "https://allsign.io/developers/docs/errors#WEBHOOK_URL_INVALID",
  "title": "Unprocessable Entity",
  "status": 422,
  "detail": "The webhook url must be an absolute https:// URL.",
  "instance": "/v3/webhooks",
  "code": "WEBHOOK_URL_INVALID",
  "requestId": "req_4404713e03b346ffbe800e0deab820a0",
  "errors": [
    {
      "field": "url",
      "code": "INVALID_VALUE",
      "detail": "Must start with https://"
    }
  ]
}
Activo

Correlación con AllSign-Request-Id

Cada respuesta trae el header AllSign-Request-Id: req_… y lo repite en requestId dentro del cuerpo del error. Cítalo al reportar un problema — es la llave para rastrear la petición en nuestros logs.