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,positiono 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.
emission_point_changes_required- Envía
codeoname. establishment_changes_required- Envía
code,nameoaddress. 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,establishmento 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}. portal_link_invalid- 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,emailophone. 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.
- 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_numbero 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
monthoyear. 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_idconinterval,cancel=trueoresume=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.
- 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_idde un plan del catálogo, otermsacordados. 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.
- 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} - 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}. - 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. - 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.
- 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.
- 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ó.
- 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.
- 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
- 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.
- 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.
- 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.