Skip to Content

Códigos

Qué significa cada código de Fiscalbase y qué decirle a quien usa tu sistema. Cada error con uno de ellos enlaza aquí.

Cada error que responde con uno de estos códigos, en el propio problema o en una entrada de errors, trae documentation_url con el enlace a su explicación en esta página. Los errores dicen cómo leer un problema; aquí está qué significa cada código, con la frase que nuestra consola le muestra a una persona. Entre llaves va el dato que el error trae junto al código: {expired_on} es la fecha que llega en expired_on.

Los códigos genéricos de forma (invalid_type, too_small, too_big, invalid_format, invalid_value, unrecognized_keys) no están aquí: los explica la página de errores. Pueden aparecer códigos nuevos; uno que no conoces se trata por su type.

Acceso y solicitudes

api_key_invalid
Falta la API key o no es válida.
api_key_required
Solo una API key abre el flujo de eventos. La plataforma tiene el suyo.
api_key_wrong_host
Esta API key funciona en {host}. Envía la llamada allí.
body_not_json
El cuerpo no es un JSON válido.
business_mismatch
Tu API key actúa para el negocio {business_id}; no indiques otro.
business_required
Indica el negocio en el encabezado Fiscalbase-Business.
channel_not_accepted
Usa api, cli o mcp.
content_type_unsupported
El tipo de contenido del cuerpo no es uno que esta ruta lea.
environment_mismatch
Tu API key emite en {environment}; no envíes otro ambiente.
environment_not_accepted
Usa sandbox, test o live.
environment_not_here
Esta dirección atiende solo {environment}.
environment_required
Indica el ambiente: sandbox, test o live.
event_streams_exhausted
Tu API key ya tiene {limit} flujos de eventos abiertos. Cierra uno primero.
file_required
Envía un archivo.
import_request_too_large
La solicitud pasa de {megabytes} MB.
internal_error
Algo falló de nuestro lado.
key_permission_insufficient
Tu API key no tiene el permiso para esto.
live_updates_without_key
Las API keys no abren actualizaciones en vivo.
manager_role_required
Solo una persona con rol owner o admin, desde la plataforma, puede hacer esto.
month_needs_year
Indica también el año.
not_organization_member
Ya no eres parte de esta organización.
organization_not_selected
Aún no eliges una organización.
person_required
Solo una persona, desde la plataforma, puede hacer esto.
platform_origin_required
Esta solicitud no viene de la plataforma.
request_too_large
La solicitud es demasiado grande.
route_not_found
No existe esta ruta.
setting_not_overridable
Esta función no admite excepciones por organización.
sign_in_or_key_required
Inicia sesión o envía tu API key.
sign_in_required
Inicia sesión en la plataforma.
too_many_requests
Demasiadas solicitudes
webhook_message_too_large
El mensaje es demasiado grande.
webhook_signature_invalid
La firma del mensaje no es válida.

Negocios, certificados y API keys

api_key_not_found
No hay una API key con este id.
barcode_check_digit_invalid
Un código de 8, 12, 13 o 14 dígitos es un EAN o un UPC y termina en su dígito verificador: el de este no coincide.
barcode_taken
Otro producto a la venta ya tiene este código de barras.
business_issues_in_sandbox_only
Este negocio es de Sandbox: emite solo en el simulador, con una API key de Sandbox (fb_sandbox_…).
business_issues_outside_sandbox
Este negocio emite en Producción, no en Sandbox.
business_kind_not_here
Aquí registras tu negocio real. Sandbox tiene su propia dirección, sandbox.fiscalbase.io.
business_not_found
No hay un negocio con este id.
business_tax_id_taken
La organización ya tiene este RUC.
category_changes_required
Envía name, position o ambos.
category_in_use
Todavía hay productos en esta categoría: pásalos a otra primero.
category_not_found
No hay una categoría de productos con este id.
certificate_cannot_sign
La clave de este certificado no sirve para firmar: su uso no incluye la firma digital.
certificate_file_invalid
Un archivo .p12 de hasta 100 KB
certificate_not_needed_in_sandbox
Un negocio de Sandbox firma con el certificado de Fiscalbase. No necesita el tuyo.
establishment_changes_required
Envía code, name o address.
establishment_not_found
Este negocio no tiene un establecimiento con este código.
event_not_found
Ningún evento de tu negocio en este ambiente tiene este id. Los eventos se guardan {days} días.
expired
El certificado venció el {expired_on}.
head_office_address_unknown
El registro del SRI no tiene la dirección de la matriz de este RUC; envíala.
hostname_invalid
Escribe un subdominio válido, como facturas.tuempresa.ec.
issuer_logo_not_found
Este negocio no tiene logo.
issuer_not_recognized
El certificado no dice de quién es; puede venir de una entidad de certificación que no reconocemos.
issuing_confirmation_mismatch
Escribe el nombre del negocio tal como aparece: {names}.
issuing_not_ready
Aún falta algo para activar la emisión de este negocio.
live_business_key_environment
Un negocio real tiene API keys de Pruebas o Producción, no de Sandbox.
live_business_not_deletable
Un negocio real no se borra: guarda comprobantes con validez tributaria. Si ya no lo usas, escríbenos.
logo_file_invalid
Un PNG o JPEG de hasta 512 KB
logo_format_invalid
Sube el logo en PNG o JPEG.
logo_too_large
El logo pesa más de 512 KB.
no_private_key
El archivo no tiene una clave privada con su certificado.
not_a_certificate
El archivo no es un certificado PKCS#12.
not_yet_valid
El certificado aún no está vigente.
notification_not_found
No hay una notificación con este id.
phone_invalid
Escribe el teléfono solo con dígitos, de 7 a 15, y un + al inicio si lleva código de país.
point_changes_required
Envía point, establishment o ambos.
portal_branding_plan_required
Tu plan no incluye el portal con tu marca: viene con Pro y A medida.
portal_code_expired
El código venció; pide uno nuevo.
portal_code_invalid
El código no coincide.
portal_code_locked
Demasiados intentos; espera 15 minutos antes de pedir otro código.
portal_cover_file_invalid
Una foto JPEG, PNG o WebP de hasta 2 MB
portal_cover_format_invalid
Sube la foto de portada en JPEG, PNG o WebP.
portal_cover_not_found
Este negocio no tiene foto de portada.
portal_cover_too_large
La foto de portada pesa más de 2 MB.
portal_document_not_found
No hay un comprobante con este id.
portal_domain_failure_certificate_failed
No pudimos emitir ni renovar el certificado del dominio: revisa sus registros DNS y vuelve a guardarlo.
portal_domain_failure_dns_not_pointing
Los registros CNAME y TXT ya no apuntan a Fiscalbase: vuelve a crearlos como te los mostramos.
portal_domain_failure_hostname_blocked
Nuestro proveedor bloqueó este dominio: escríbenos para revisarlo.
portal_domain_failure_hostname_removed
Nuestro proveedor ya no tiene este dominio: quítalo y vuelve a agregarlo.
portal_domain_failure_unknown
No pudimos verificar el dominio: revisa sus registros DNS.
portal_domain_not_found
Este negocio no tiene un dominio del portal.
portal_domain_plan_required
Tu plan no incluye un dominio propio del portal: viene con A medida.
portal_domain_taken
Ese dominio ya está configurado en otro negocio.
portal_email_change_not_found
No hay un cambio de correo con este id.
portal_email_change_resolved
La solicitud ya se resolvió: {status}.
Este enlace no abre nada; puede haber vencido.
portal_not_found
Aquí no hay un portal.
portal_page_not_found
No encontramos esa página.
portal_session_required
Primero inicia sesión en el portal.
practice_business_name_required
Un negocio de práctica inventa sus datos: envía legal_name, no ruc.
practice_ruc_in_live_business
El RUC {ruc} es el de práctica de Sandbox: un negocio real necesita su RUC real.
product_changes_required
Envía al menos un campo para cambiar.
product_image_format_invalid
Envía la foto en JPEG, PNG o WebP.
product_image_not_found
Este producto no tiene foto.
product_image_not_square
La foto debe ser cuadrada.
product_image_too_large
La foto pesa más de 2 MB.
product_not_found
No hay un producto con este id o código de barras.
product_price_required
Un producto vendido por unidad o por peso necesita price_with_iva.
recipient_changes_required
Envía name, email o phone.
recipient_exists
Ya tienes un cliente con esta identificación: cámbialo con PATCH.
recipient_not_found
No le has emitido comprobantes a esta persona.
regime_unknown
El registro del SRI no dice en qué régimen está este RUC; indícalo.
registry_field_locked
Este dato viene del registro del SRI: un negocio real no lo cambia a mano. Actualízalo desde el registro.
registry_unavailable
No se puede consultar el registro del SRI en este momento.
ruc_flagged
El SRI marca este RUC como empresa fantasma o con transacciones inexistentes.
ruc_not_active
El SRI registra este RUC como {status}.
ruc_not_registered
El SRI no tiene un contribuyente con este RUC.
sandbox_business_free
Un negocio de Sandbox es gratis: no tiene plan ni cobros.
sandbox_business_key_environment
Un negocio de Sandbox solo tiene API keys de Sandbox.
sandbox_business_no_registry
Un negocio de práctica tiene datos inventados. No hay registro del SRI que leer.
sandbox_business_not_for_production
Un negocio de Sandbox no pasa a Producción. Para emitir con validez tributaria, regístrate en platform.fiscalbase.io con tu RUC.
sandbox_business_ruc_required
Escribe el RUC de tu negocio. Sandbox completa el resto con el registro del SRI.
series_changes_required
Envía active, next_number o ambos.
signing_certificate_missing
El negocio no tiene un certificado de firma vigente.
special_taxpayer_resolution_required
El SRI registra este RUC como contribuyente especial; su número de resolución va en cada comprobante.
support_whatsapp_format
Con código de país, sin el signo más
tax_id_mismatch
El certificado es de {certificate_tax_id}, no del RUC {business_tax_id}.
taxpayer_not_found
El SRI no tiene a nadie con esta identificación.
view_limit_reached
Puedes guardar hasta {limit} vistas.
view_name_taken
Ya tienes una vista con este nombre.
view_not_found
No hay una vista con este id.
webhook_delivery_not_found
No hay una entrega con este id en este endpoint.
webhook_endpoint_not_found
No hay un endpoint de webhooks con este id.
webhook_event_unknown
Tipo de evento desconocido: {event}. {withdrawn} ya no está vigente (se aplicó hasta el {until}): usa {nearest}, el vigente. Elige uno de los {count} códigos de la tabla.
webhook_url_not_https
Usa una URL HTTPS.
webhook_url_not_public
Usa una dirección pública: localhost, las redes privadas y las direcciones locales no son alcanzables desde Fiscalbase.
withholding_agent_resolution_required
El SRI registra este RUC como agente de retención; su número de resolución va en cada comprobante.
wrong_password
La clave del certificado es incorrecta.

Planes, cobros y retenciones recibidas

address_not_registered
Escribe tu dirección: el registro del SRI no la tiene.
billing_profile_missing
Este negocio aún no tiene perfil de facturación.
billing_profile_without_email
El perfil de facturación no tiene correo.
business_without_plan
Este negocio aún no tiene un plan.
card_billing_needs_catalogue_plan
El cobro con tarjeta es de los planes del catálogo: acuerda los precios con cobro manual o sin cobro.
card_plan_canceled_by_customer
Este plan se cobra con tarjeta: lo cancela el cliente desde Plan y uso.
charge_already_paid
El cobro {reference} ya está pagado.
charge_not_found
No hay un cobro con este id.
charge_not_owed
El cobro {reference} ya no se debe.
charge_overdue
Un cobro de este negocio está vencido.
charge_paid_by_card
Este cobro se paga con tarjeta: el pago lo confirma la pasarela.
charge_search_invalid
Busca por la referencia completa (12 dígitos) o por monto (33.35).
charged_plan_needs_price
Un plan que cobramos necesita un precio mayor que cero.
checkout_in_progress
Ya estamos abriendo la página de pago; espera un momento.
checkout_not_found
No hay un pago con tarjeta de este negocio con esta orden.
credit_note_exceeds_balance
La nota de crédito (USD {total}) supera el saldo acreditable de la factura {invoice_number}: USD {balance}.
custom_plan_agreed_with_us
El plan A medida se acuerda con nosotros.
custom_plan_has_no_price
El plan A medida se acuerda con cada negocio: no tiene precio.
first_payment_pending
Falta el primer pago de este negocio.
flag_not_found
No hay una función con esta clave.
identification_not_registered
El registro del SRI no tiene esta identificación.
included_documents_invalid
Los comprobantes incluidos deben ser cero o un entero positivo.
interval_invalid
El intervalo es month o year.
interval_not_sold
Este plan no se vende con ese intervalo.
live_business_not_found
No hay un negocio real con este id.
no_plan_to_cancel
No tienes un plan que cancelar.
no_plan_to_end
El negocio no tiene un plan que terminar.
one_change_only
Envía solo uno: plan_id con interval, cancel=true o resume=true.
open_charge_pending
Paga el cobro abierto antes de pasar a un plan mayor.
open_charge_pending_card
Hay un cobro abierto: actualiza la tarjeta para pagarlo ahora.
operator_only
Solo un operador de Fiscalbase puede hacer esto.
organization_not_found
No hay una organización con este id.
payment_amount_mismatch
Este cobro espera USD {owed}: el total menos las retenciones registradas. Un pago parcial o de más se resuelve a mano.
payment_date_in_future
El pago no puede ser de una fecha futura.
payment_gateway_unconfigured
Aún no podemos cobrar con tarjeta.
payment_not_found
No hay un pago con este id.
payment_page_unavailable
No pudimos abrir la página de pago.
phone_invalid
Solo dígitos, con el código de país
plan_ending
Tu plan está por terminar: reanúdalo antes de cambiarlo.
plan_feature_unknown
El plan tiene una función desconocida.
plan_managed_by_fiscalbase
Tu plan lo administra Fiscalbase: escríbenos a {support_email} para cambiarlo.
plan_not_card_billed
Tu plan no se cobra con tarjeta.
plan_not_ending
Tu plan no está por terminar.
plan_or_terms_required
Envía plan_id de un plan del catálogo, o terms acordados.
plan_purchases_coming_soon
La compra de planes llega pronto.
plan_quota_reached
Este negocio ya emitió los {included} comprobantes que su plan permite este mes.
plan_required
Este negocio aún no tiene un plan.
plan_unavailable
El plan no existe o ya no está disponible.
price_invalid
Escribe el precio en USD con hasta dos decimales.
refund_exists
Este pago ya tiene un reembolso en curso o hecho.
refund_not_found
No hay un reembolso con este id.
refund_not_possible
Solo se reembolsa un pago con tarjeta de un cobro pagado.
refund_not_unknown
Este reembolso ya no está sin confirmar.
refund_unconfirmed
El proveedor de pagos no confirma este reembolso: revísalo en su panel y márcalo a mano.
sandbox_for_practice
Sandbox es solo para negocios de práctica.
setting_not_found
No hay un ajuste con esta clave.
team_limit_reached
Tu equipo ya tiene las {limit} personas que permite tu plan. Pasa a {plan} para invitar a más.
withholding_already_recorded
Esta retención ya está registrada.
withholding_empty
La retención debe retener algo de renta o de IVA.
withholding_issuer_mismatch
La retención la emitió el RUC {issuer_ruc}, no el del perfil de facturación ({profile_ruc}).
withholding_key_invalid
No es una clave de acceso válida: 49 dígitos con su dígito verificador.
withholding_key_not_withholding
La clave de acceso no es de un comprobante de retención.
withholdings_exceed_total
Las retenciones pasarían del total del cobro, USD {total}.

Comprobantes y sus datos

additional_discount_exceeds_base
El descuento adicional es mayor que la base de esa tarifa.
additional_info_duplicate_name
Los nombres no se pueden repetir.
additional_info_overflow
Hasta {room} entradas (el comprobante admite {maximum} y {ours} son nuestras).
additional_info_reserved_name
Nombres reservados: {names}
authorization_number_format
Una autorización tiene 49 dígitos (o 10 o 37 las antiguas).
banana_boxes_required
La retención {withholding_code} por compra de banano necesita las cajas compradas.
banana_boxes_unexpected
Las cajas de banano van solo con los códigos 338, 340, 341, 342, 342A y 342B.
cedula_invalid
Esta cédula no es válida: revisa sus dígitos.
cedula_length
Una cédula tiene 10 dígitos.
construction_material_code_required
Una línea con IVA del 5 % necesita el código del material de construcción de la Tabla 31 del SRI, por ejemplo F010401 para el cemento.
consumidor_final_limit_exceeded
Un comprobante de más de USD {limit} debe identificar al comprador.
country_code_unknown
Un código de país de la tabla 25 del SRI, por ejemplo 593, o su código ISO de dos letras, como EC. {withdrawn} ya no está vigente (se aplicó hasta el {until}): usa {nearest}, el vigente. Elige uno de los {count} códigos de la tabla.
decimal_digits
Hasta {total} dígitos
decimal_format
Un decimal no negativo con hasta {fraction} decimales.
discount_exceeds_gross
El descuento es mayor que la cantidad por el precio unitario.
dividends_required
Un sustento de dividendos (10) necesita los datos del dividendo.
dividends_unexpected
Los datos del dividendo van solo con el sustento 10.
document_number_format
Un número de comprobante tiene la forma 001-001-000000123.
establishment_code_format
Tres dígitos, por ejemplo 001
export_buyer_address_required
Una factura de exportación necesita la dirección del comprador (anexo 4).
fiscal_year_format
Un año, por ejemplo 2025
foreign_regime_is_ecuador
Un régimen fiscal del exterior no es Ecuador.
foreign_subject_to_withholding_required
Sin convenio de doble tributación, indica si el pago está sujeto a retención.
fuel_description_mismatch
El combustible {line_code} se describe como {fuel} (tabla 30).
fuel_plate_required
Una venta de combustible necesita la placa del vehículo (anexo 12); sin vehículo, ZZZ9999.
ice_base_needs_rate
La base solo aplica a un ICE ad valorem: indica también rate.
ice_rate_required
Indica la tarifa ad valorem (rate), la específica (unit_amount) o ambas.
identification_invalid
Esta identificación no es válida: revisa sus dígitos.
identification_length
Un RUC de 13 dígitos o una cédula de 10
incoterm_format
Un incoterm en mayúsculas, por ejemplo FOB o CIF
irbpnr_bottles_required
El IRBPNR se cobra por botella: con una cantidad fraccionaria, indica bottles.
iva_rate_repeated_or_uncharged
Indica una vez cada tarifa de IVA, y solo las que cobra el comprobante.
iva_refund_buyer_needs_cedula
La devolución de IVA a personas adultas mayores es para un comprador con cédula (anexo 20).
iva_refund_exceeds_iva
La devolución de IVA no puede superar el IVA de esa tarifa.
line_excise_repeated
Una línea lleva a lo sumo un ICE y un IRBPNR.
line_iva_required
Cada línea lleva exactamente un IVA.
negotiable_address_required
Un comprobante negociable necesita la dirección (anexo 11).
negotiable_term_required
Un comprobante negociable necesita el plazo de cada pago (anexo 11).
non_resident_code_needs_foreign_payment
El código {withholding_code} es de un pago a un no residente: indica el pago al exterior en su documento de sustento.
payment_amount_required
Cada pago necesita un monto cuando hay más de uno.
payments_total_mismatch
Los pagos suman {paid}, pero el total es {total}.
plastic_bag_ice_misplaced
El ICE de fundas plásticas va en una línea con código ICE-FPN-01 o ICE-FPR-02 (anexo 18).
plastic_bag_ice_required
Las fundas plásticas {line_code} llevan ICE {ice_code} (anexo 18).
plate_format
Letras, dígitos y guiones, sin espacios, hasta 20 caracteres
reimbursed_document_type_length
En un comprobante de retención, el tipo reembolsado tiene dos dígitos.
reimbursed_rate_integer
En un comprobante de retención, la tarifa de un impuesto reembolsado es un entero.
reimbursement_required
Un comprobante de reembolso (41) necesita los comprobantes reembolsados.
reimbursement_unexpected
Los reembolsos van solo con el documento de sustento 41.
resolution_agent_format
Hasta 8 dígitos, no todos ceros.
resolution_special_taxpayer_format
De 3 a 5 letras y dígitos
ruc_invalid
Este RUC no es válido: revisa sus dígitos.
ruc_length
Un RUC tiene 13 dígitos.
self_withholding_percent
La autorretención {withholding_code} es del {allowed} %.
self_withholding_support
La autorretención {withholding_code} se sustenta en el documento 42 con sustento 12 (anexo 19).
supplier_type_required
Obligatorio para un proveedor del exterior
tax_haven_country
Un paraíso fiscal se identifica con un país de la tabla 17 del ATS.
text_single_line
Debe ocupar una sola línea.
text_xml_characters
Contiene caracteres de control que XML no admite.
tip_exceeds_limit
La propina no puede superar el 10 % del subtotal sin impuestos (tabla 21).
transport_ends_before_start
El traslado no puede terminar antes de empezar.
transport_member_needs_ruc
El servicio de transporte de un socio ({line_code}) se factura a la operadora, con su RUC.
transport_plate_format
La placa de un servicio de transporte tiene tres letras y cuatro dígitos, por ejemplo PCM4567 o ABC0123 (tabla 33).
transport_plate_required
Un servicio de transporte que factura la operadora ({line_code}) necesita la placa del vehículo.
transport_starts_before_issue
El traslado no puede empezar antes de emitir el comprobante (error 82 del SRI).
unsubsidized_price_below_unit_price
El precio sin subsidio no puede ser menor que el precio unitario.
withholding_percent_mismatch
El código {withholding_code} retiene el {known} % al {date}.
withholding_percent_not_listed
El código {withholding_code} no retiene ese porcentaje al {date}. {withdrawn} ya no está vigente (se aplicó hasta el {until}): usa {nearest}, el vigente. Elige uno de los {count} códigos de la tabla.
withholding_percent_required
Indica el porcentaje del código {withholding_code}. {withdrawn} ya no está vigente (se aplicó hasta el {until}): usa {nearest}, el vigente. Elige uno de los {count} códigos de la tabla.
withholding_percent_unknown
No conocemos el porcentaje del código {withholding_code} al {date}: indícalo en percent.
withholding_rate_digits
Hasta 3 dígitos en la tarifa de un comprobante de retención

Emisión, numeración e importaciones

access_key_invalid
La clave de acceso no es válida.
access_key_not_invoice
Solo se consultan facturas: es la que sustenta una retención.
access_key_wrong_environment
La clave es del ambiente {key_environment}, y tu API key es de {environment}.
annulment_before_issue
La anulación no puede ser anterior a la emisión.
annulment_in_future
La anulación no puede ser de una fecha futura.
credit_note_reference_required
Deja el comprador o una línea a la factura solo cuando la eliges por su id; si no, envíalos completos.
credited_line_ambiguous
La factura tiene varias líneas con el código {code}; envía esta línea completa.
credited_line_indivisible
La línea {code} de la factura indica la base del ICE o las botellas del IRBPNR, que no se pueden dividir; envíala completa para acreditar una parte.
credited_line_not_found
La factura no tiene una línea con el código {code}.
credited_lines_unavailable
La factura fue importada y sus líneas no se pueden elegir por código; envíalas completas.
credited_quantity_exceeded
La línea {code} de la factura vendió {quantity}; la nota de crédito no puede acreditar más.
credited_quantity_exceeds_left
A la línea {code} de la factura solo le quedan {left} por acreditar: las notas de crédito anteriores se llevaron el resto.
cursor_invalid
Este cursor no viene de esta API.
delivery_address_not_named
El SRI no confirmó este comprobante, así que solo puedes enviarlo a las direcciones que él mismo nombra, y {address} no es una de ellas.
delivery_without_email
El comprobante no tiene una dirección de correo.
document_changed_while_annulling
El comprobante cambió mientras se anulaba.
document_changed_while_correcting
El comprobante cambió mientras se corregía.
document_changed_while_renumbering
El comprobante cambió mientras se renumeraba.
document_file_missing
El comprobante {document_id} aún no tiene {kind}.
document_not_annullable
El comprobante está en estado {status}; solo se anula uno authorized.
document_not_authorized
El comprobante está en estado {status}.
document_not_correctable
El comprobante está en estado {status}; solo se corrige uno returned o not_authorized.
document_not_found
No hay un comprobante con este id.
document_not_renumberable
Solo se renumera un comprobante devuelto con el error 45, SECUENCIAL REGISTRADO.
documents_not_found
No hay un comprobante con uno de estos ids.
draft_not_found
No hay un borrador con este id.
draft_too_large
El borrador no puede pesar más de 256 KB y debe ser un objeto JSON.
draft_type_unknown
No hay un tipo de comprobante {object}.
email_unnamed_limit_reached
Tu organización llegó al límite de hoy de correos a direcciones que el comprobante no nombra. Envía a las que cada comprobante nombra, o inténtalo de nuevo en {retry_after_seconds} segundos.
emission_point_already_numbered
Este punto de emisión ya numeró comprobantes: su código está en sus números y claves de acceso, y no se cambia. Ábrelo de nuevo con el código correcto.
emission_point_has_no_numbering
No hay numeración en este punto de emisión.
establishment_already_numbered
Este establecimiento ya numeró comprobantes: su código está en sus números y claves de acceso, y no se cambia. Ábrelo de nuevo con el código correcto.
establishment_not_open
El SRI no registra un establecimiento {establishment} abierto para el RUC {ruc}.
export_too_large
Son más de {limit} comprobantes: acota la exportación con filtros.
file_not_ready
El archivo se está preparando.
final_consumer_not_annullable
El SRI no anula comprobantes emitidos a consumidor final.
gap_not_found
Esta serie no tiene un faltante resuelto con este id.
gap_not_open
Esos números no faltan en esta serie.
gap_settled_by_sri
El SRI resolvió esos números: su comprobante fue anulado o no autorizado.
held_document_not_found
No hay una venta en espera o fallida con este id.
held_request_invalid
Esta venta ya no cumple lo que la API acepta: vuelve a emitirla.
idempotency_key_in_progress
Una solicitud con este Idempotency-Key sigue en curso. Espera un momento y envíala de nuevo.
idempotency_key_required
Falta el encabezado Idempotency-Key: sin él, un reintento lo haría otra vez.
idempotency_key_reused
Este Idempotency-Key ya se usó con otra solicitud.
ids_repeated
No repitas un id.
import_failure_archive_too_large
Los XML y listados de los ZIP pesan más de 500 MB descomprimidos, o un listado dentro de un ZIP más de 50 MB. Divide la importación, por ejemplo por año.
import_failure_nested_archive
Un ZIP tiene otro ZIP adentro, y no abrimos un ZIP dentro de otro. Súbelo por separado.
import_failure_no_documents
No encontramos ningún comprobante XML ni clave de acceso en los archivos.
import_failure_report_not_addressed
El reporte es de otro negocio: sus filas no lo nombran como emisor ni como receptor. Descarga el reporte de este negocio y vuelve a subirlo.
import_failure_too_many_documents
Hay más de 20.000 comprobantes, o un ZIP con más de 100.000 archivos. Divide la importación, por ejemplo por año.
import_failure_unreadable_archive
Un archivo ZIP está dañado y no se pudo leer.
import_file_is_office
Es una hoja de cálculo u otro archivo de Office. Si es un listado de comprobantes, guárdalo como CSV o texto y súbelo así.
import_file_is_pdf
Es un PDF: el RIDE no prueba que el comprobante esté autorizado. Sube el XML.
import_file_unsupported
No es un XML, un ZIP ni un archivo de texto con claves de acceso.
import_files_count
Sube de 1 a {maximum} archivos.
import_item_already_exists
Ya estaba en Fiscalbase; no se importó de nuevo.
import_item_annulled
El SRI lo reporta anulado; no se importa, pero su número queda reservado.
import_item_annulment_pending
Importado. El SRI confirmó que está autorizado; tiene una anulación que espera la aceptación del receptor y sigue válido hasta que el SRI lo anule.
import_item_authorization_mismatch
La fecha de autorización del archivo no coincide con la que tiene el SRI.
import_item_canceled
Cancelaste la importación antes de procesarlo.
import_item_certificate_expired
El certificado no estaba vigente cuando se firmó.
import_item_certificate_mismatch
Lo firmó un certificado que no es de este RUC.
import_item_confirmed_by_sri
Importado. El SRI confirmó que está autorizado.
import_item_entry_too_large
Pesa más de 1 MB; ningún comprobante del SRI es tan grande.
import_item_evidence_added
Ya estaba en Fiscalbase; el listado del SRI que subiste ahora confirma su autorización.
import_item_invalid_access_key
La clave de acceso no es válida o no coincide con los datos del comprobante.
import_item_invalid_signature
No tiene una firma válida: falta, o el comprobante cambió después de firmarse.
import_item_issuer_signature_only
Importado solo con tu firma: nada muestra que el SRI lo autorizó, así que no aparece en el portal. El SRI ya no responde por él, pues solo recuerda los comprobantes de los últimos dos meses más o menos, así que no podemos saber si se anuló. Sube el listado del SRI donde aparece (el reporte del Facturador o el de emitidos de SRI en línea) para confirmarlo.
import_item_listed_by_sri
Importado: el listado del SRI que subiste lo muestra autorizado. El SRI ya no responde por él, pues solo recuerda los comprobantes de los últimos dos meses más o menos, así que no podemos saber si se anuló.
import_item_no_received_documents_in_test
Te lo emitió el RUC {ruc}, y Pruebas no guarda comprobantes recibidos: impórtalo en Producción.
import_item_no_sri_in_sandbox
Sandbox no consulta al SRI, así que no puede traer el XML de una clave de acceso; su número queda reservado. Sube el XML para importarlo.
import_item_not_a_document
No es un comprobante electrónico del SRI.
import_item_not_authorized
No fue autorizado por el SRI; no se importa, pero su número queda reservado.
import_item_not_importable
No podemos importar este comprobante en tu cuenta. Escríbenos si crees que es un error.
import_item_number_taken
Ya tienes otro comprobante con el número {number} en esta serie.
import_item_received
Te lo emitió el RUC {ruc}: va a tus comprobantes recibidos.
import_item_signature_only
Importado con la autorización que trae el archivo, que nadie firma. El SRI ya no responde por él, pues solo recuerda los comprobantes de los últimos dos meses más o menos, así que no podemos saber si se anuló.
import_item_sri_unavailable
El SRI no respondió en 24 horas. Vuelve a subir el archivo; lo ya importado saldrá como duplicado.
import_item_unknown_code
Tiene {field} {value}, un código que no está en las tablas del SRI.
import_item_unknown_to_sri
El SRI no conoce esta clave de acceso. Si lo emitiste hace minutos, vuelve a importarlo más tarde.
import_item_unreadable_xml
No es un XML que podamos leer. Revisa que el archivo no esté dañado.
import_item_unsupported_version
Usa la versión {version} del esquema de {family}, que aún no podemos leer.
import_item_wrong_environment
Es un comprobante de Pruebas. Impórtalo con una API key de ese ambiente.
import_item_xml_unavailable
El SRI ya no entrega su XML: solo lo hace por unos dos meses. Su número queda reservado; para importarlo, sube su XML de tu sistema anterior o del Facturador del SRI.
import_not_cancelable
Solo se cancela una importación queued o processing.
import_not_found
No hay una importación con este id.
imports_in_flight
Ya hay {limit} importaciones en curso; espera a que termine una.
issuing_not_active
La emisión de este negocio aún no está activa.
metadata_filter_repeated
Cada clave de metadata va una sola vez.
metadata_filters_too_many
Hasta {maximum} pares de metadata
metadata_key_invalid
Las claves tienen de 1 a 40 caracteres, sin corchetes.
metadata_too_many
Hasta 20 claves
next_number_taken
La numeración ya entregó ese número; el siguiente solo puede avanzar.
no_files_yet
Ninguno de los comprobantes tiene archivos aún.
no_free_emission_point
Otros sistemas usaron todos los puntos del establecimiento {establishment} en los últimos 24 meses.
period_reversed
La fecha inicial es posterior a la final.
period_too_long
El rango abarca más de {days} días: acórtalo.
preview_mismatch
El comprobante no es el de la vista previa, o la vista previa es de otro día; genérala de nuevo.
query_field_unknown
Campo desconocido
received_document_xml_unavailable
Este comprobante recibido no tiene XML: nunca llegó, o solo su emisor puede entregarlo.
reference_final_consumer
Una factura emitida a consumidor final no admite notas de crédito.
reference_not_authorized
La factura está en estado {status}; solo puedes referir una autorizada.
reference_not_found
No hay una factura con este id para este negocio y este ambiente.
series_already_fiscalbase
Fiscalbase ya emite en esta serie: no hay nada que continuar.
series_exists
Este negocio ya numera ese tipo de comprobante en este establecimiento y punto de emisión.
series_not_fiscalbase
Otro sistema emite en esta serie: para seguir su numeración en Fiscalbase, continúala.
series_not_found
No hay una numeración con este id.
series_not_set_up
No hay una numeración activa de {document_type} en {environment}.
series_used_elsewhere
Otro sistema emitió en el punto {establishment}-{emission_point} en los últimos 24 meses; usa el {suggested_establishment}-{suggested_emission_point} o continúa su numeración.
simulate_needs_sandbox
Solo las API keys de Sandbox (fb_sandbox_…) pueden simular.
sri_invoice_annulled
El SRI registra este comprobante como anulado.
sri_invoice_expired
El SRI ya no responde por un comprobante de hace tanto tiempo.
sri_invoice_not_authorized
El SRI no autorizó este comprobante.
sri_invoice_not_delivered
El SRI no entregó el comprobante.
sri_invoice_not_found
El SRI no tiene un comprobante con esta clave.
sri_invoice_unreadable
No pudimos leer la factura que entregó el SRI.
sri_unreachable
No se puede consultar el SRI en este momento.
status_refreshed_recently
Ya consultamos este comprobante hace un momento.
suggestion_source_required
Nombra la factura de una sola forma: su clave de acceso, el comprobante recibido, o sus datos con la identificación de quien la emitió.
supplier_identification_required
Indica el RUC o la cédula de quien emitió la factura: si es contribuyente especial o RIMPE decide los porcentajes.
test_keeps_no_received_documents
Pruebas no guarda comprobantes recibidos: es donde un negocio ensaya su emisión.

Comprobantes recibidos y webhooks

backfill_running
Este endpoint ya está reenviando sus comprobantes; espera a que termine.
backfill_since_future
Elige una fecha que no sea futura.
event_not_in_test
Pruebas no guarda comprobantes recibidos: un endpoint de Pruebas no recibe {event}.
received_document_not_found
No tienes ese comprobante recibido.