Saltar al contenido principal
En esta página

La aceptación es solo la mitad de una decisión de pago; la otra mitad es el coste que implica la aprobación. Los datos de costes llegan a Athia como una carga CSV, en lugar de una conexión a API, ya que las tarifas contractuales, los precios por método y los calendarios de tarifas son términos comerciales que se encuentran en acuerdos y hojas de cálculo: la mayoría de los proveedores no exponen ninguna API para ellos. Un archivo es la única fuente completa.

Una vez cargados los datos de costes, Athia puede pasar de "qué proveedor aprueba más" a "qué proveedor aprueba más por unidad de coste", fijar el precio de un cambio de ruta antes de realizarlo y separar un aumento de tarifas al que usted ha accedido de uno al que no.

Las dos conexiones de costes#

ConexiónQué contienePlantilla
Tarifas de pago con tarjetaSus tarifas de procesamiento de tarjetas y calendario de tarifascard-payment-fees-template.csv
Tarifas de pago no con tarjetaTarifas y calendarios para todo lo que no sea una tarjeta: transferencias bancarias, billeteras, efectivo y métodos localesnon-card-payment-fees-template.csv

Manténgalos separados, incluso si un solo proveedor maneja ambos. Las tarifas de tarjetas se descomponen de forma diferente de las tarifas no con tarjeta, y el modelo de costes de Athia las trata como objetos diferentes.

Antes de empezar#

No se requieren requisitos de consola del proveedor ni credenciales para este conector: es una carga de archivo, no una conexión a API. Lo que necesita antes de abrir el asistente:

  • La plantilla CSV de Athia. Descárguela del paso 2 del asistente ("¿Necesita ayuda con el formato? Descargue nuestra plantilla CSV para ver la estructura esperada.") y rellénela. La plantilla define las columnas que Athia espera, en el orden en que las espera. Es la definición de formato oficial: un archivo ensamblado desde la memoria o desde una exportación del proveedor normalmente fallará en la validación.
  • La propia tarjeta de tarifas, según lo acordado: sus tarifas contractuales, precios por método y calendario de tarifas para el período que cubre el archivo.
  • Las regiones de operación a las que se aplica el acuerdo.

Campos de configuración#

CampoRequeridoQué es / dónde encontrarlo
Nombre de la conexiónSíSu etiqueta para esta tarjeta de tarifas. Nómbrela para el acuerdo que representa, incluyendo el período de validez, para que la siguiente persona pueda distinguir entre dos tarjetas de tarifas.
Regiones de OperaciónSíUna o más de Todas las Regiones, México, Estados Unidos, Asia Pacífico. Las regiones a las que se aplica el acuerdo. Al hacer clic en Siguiente sin seleccionar ninguna región, se bloquea con un mensaje de validación.
Archivo CSVSíTu copia completa del modelo Athia. Solo .csv es aceptado.

Configuración#

El asistente tiene tres pasos: Configuración → Cargar archivo → Validar.

  1. Ir a Configuración → Conexiones y seleccionar + Añadir Conexión.
  2. En Datos de Costos, seleccionar Tarifas de pago con tarjeta o Tarifas de pago no con tarjeta.
  3. Paso 1, Configurar Conector: introduzca un Nombre de la conexión y marcar uno o más Regiones de Operación. Ambos son obligatorios.
  4. Paso 2, Subir Archivo CSV: descargar el modelo si aún no lo tienes, luego arrastra tu archivo a la zona de arrastre o utiliza Explorar Archivos.
  5. Seleccionar Validar Datos.

La validación comprueba el archivo frente a la estructura esperada antes de que se ingrese cualquier dato, por lo que un archivo mal formado se rechaza al subir, en lugar de aparecer más tarde como números de costo incorrectos en una respuesta. Si la validación falla, corrige el archivo y vuelve a subir — no se conservan datos parciales.

Cadencia de sincronización#

Los datos de costes representan un momento específico de un acuerdo comercial, por lo que quedan obsoletos en el momento en que cambian sus precios. Sube un archivo actualizado siempre que:

  • renegocie las tarifas,
  • añadas un proveedor o método de pago,
  • introduzca un nuevo mercado, o
  • reciba un nuevo calendario de tarifas.

Trate de ello como un punto de revisión trimestral, incluso si no ha habido cambios evidentes: los cambios en las tarifas y los honorarios se aplican sin necesidad de una conversación.

Límites y aspectos importantes#

  • Solo .csv los archivos están soportados. No se admiten hojas de cálculo de Excel, ni archivos comprimidos.
  • El formato del archivo es el especificado en la plantilla. Las columnas requeridas están definidas en la plantilla descargable, y no en la documentación del producto. El tamaño del archivo, el número de filas y los límites de columnas no se publican.
  • La subida es "todo o nada". Un archivo que falla la validación es rechazado por completo; no existe la posibilidad de importar solo una parte.
  • El comportamiento de "reemplazo" no está especificado en el producto. No se define en el asistente si una nueva subida reemplaza las tarifas anteriores o se mantiene junto con ellas. Asigne un nombre a cada subida para el acuerdo y el período que cubre, y confirme con su equipo de Athia qué tarifa está vigente antes de confiar en una cifra de coste que abarque un cambio de precios.
  • Una tabla de tarifas no es una factura. Indica a Athia lo que deberías se aplicarán, no lo que había pagado. Los registros reales de liquidación y tarifas provienen de los conectores del proveedor, y su granularidad de tarifas varía: Checkout.com Además, Adyen proporciona los detalles de tarifas más completos, mientras que Stripe informa sobre tarifas combinadas, sin información detallada sobre los cargos. La posibilidad de analizar las variaciones de tarifas se basa en la carga de sus tarifas contractuales y los registros reales de tarifas de su proveedor. Consulte Conectores de Athia para el catálogo de conectores de proveedores.

Resolución de problemas#

SíntomaCausa probableSolución
Siguiente Está bloqueado en el paso 1No se ha seleccionado ninguna región de operaciónMarque al menos una de las siguientes opciones: Todas las regiones, México, Estados Unidos, Asia Pacífico
El archivo es rechazado en la zona de cargaEl archivo no es un .csv — normalmente debido a .xlsx ni un archivo ZIPExportar a CSV y subir el archivo sin formato
La validación fallaEl archivo no coincide con la estructura esperada, generalmente porque se creó a partir de una exportación del proveedor o de la memoria, en lugar de la plantillaDescargue la plantilla del paso 2, transfiera sus tarifas a ella y suba nuevamente
Los cálculos de costes parecen incorrectos en un cambio de preciosIncertidumbre sobre qué tarifa está vigente para el períodoConfirme la tarifa vigente con su equipo de Athia; asegúrese de que cada subida tenga un nombre que corresponda a su acuerdo y período de validez
Las tarifas reportadas no coinciden con la tarifaLa tarifa es el precio contratado, no los importes facturadosCompare con los registros de cobro y tarifas del proveedor a través de los conectores del proveedor; espere tarifas combinadas de Stripe