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.
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ódigo
Status
Título
Estado
ANNEX_OF_ANNEX_NOT_ALLOWED
409
ConflictAsí 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 requiredAsí 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 foundAsí 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 foundAsí 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 foundAsí 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 environmentAsí 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 signedAsí 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 conflictAsí 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
ConflictAsí 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 foundAsí 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
ConflictAsí 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 sendableAsí 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 largeAsí 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 signerAsí 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 exceededAsí 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 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 takenAsí 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 foundAsí 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
ConflictAsí 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 foundAsí 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 progressAsí 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 invalidAsí 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 requiredAsí 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 reusedAsí 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 cursorAsí se ve · verificado
Respuesta real de sandbox a GET /v3/documents?startingAfter=pagina-2 (ver la operación), backend 24c0469.
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
ConflictAsí 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 AllowedAsí 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 yetAsí 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 signsAsí 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 foundAsí 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 signedAsí 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 deniedAsí 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 unavailableAsí se ve · verificado
Respuesta real de sandbox a GET /v3/templates/tmpl_2a1bc982e2f04c979ff8d8c2a6468539/preview (ver la operación), backend 24c0469.
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 signerAsí 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 foundAsí 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 foundAsí 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 signerAsí 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 invalidAsí 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 FoundAsí 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 incompleteAsí 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 requiredAsí 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 useAsí 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 foundAsí 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 typeAsí 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 versionAsí se ve · verificado
Respuesta real de sandbox a GET /v3/documents (ver la operación), backend 24c0469.
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 failedAsí 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 foundAsí 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 invalidAsí 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.