Facturiadocs
Errores

muestras_approval_required

Las muestras impresas de esta empresa están armadas y nadie ha aprobado enviarlas todavía.

Las muestras impresas de esta empresa están armadas y nadie ha aprobado enviarlas todavía.

Códigomuestras_approval_required
Tipounprocessable_error — Bien formado, pero viola una regla del dominio
HTTP422
¿Reintentable?No

Qué hacer

LAS SUBE Y LAS ENVÍA FACTURIA (G4, 2026-09-07), detrás de la cerca ALLOW_LIVE_MUESTRAS_UPLOAD. Lo que falta es que una persona las MIRE: el SII revisa la representación impresa —la hoja que recibe tu cliente— y ésa es la identidad impresa de tu empresa por años; enviada una muestra, no hay pantalla para retirarla. onboarding.steps[] trae la página de aprobación, que lista uno por uno los PDF que se enviarían.

Reintentar el mismo request va a fallar igual. Cambia el request, no la frecuencia.

El sobre

{
  "error": {
    "type": "unprocessable_error",
    "code": "muestras_approval_required",
    "message": "…",
    "hint": "FACTURIA UPLOADS AND FILES THEM (G4, 2026-09-07), behind ALLOW_LIVE_MUESTRAS_UPLOAD. What is owed is that a person LOOK at the kit: the SII reviews the printed representación — the page a customer receives — and that is the empresa's printed identity for years, with no «retirar» beside «Enviar al SII». `onboarding.steps[]` carries the approval page, which lists every PDF that would be sent.",
    "retriable": false,
    "doc_url": "https://docs.facturia.cl/errors/muestras_approval_required",
    "request_id": "req_01K2R7Q9M4T2VB"
  }
}

Programa contra code, nunca contra message — la prosa se puede reescribir, el código no (§5.8).

hint y retriable llegan en la respuesta, con estos mismos valores: son función del code y salen del mismo diccionario que sirve GET /v1/error_codes, así que el sobre y el diccionario no pueden discrepar. hint va en inglés a propósito — el español de este código es esta ficha. Más en El sobre de error.

También

La copia legible por máquina de esta ficha vive en GET /v1/error_codes, sin autenticación.

En esta página