Del estado de un pago al asiento en tu ERP: una propuesta.
Esta página es una propuesta conceptual, no una función del producto. CodeSpar no escribe en ERPs: Omie y Tiny no son conectores a los que enrute, y Bling se enruta solo para emitir NFS-e. Lo que existe para construir encima: codespar_pay lee el estado de cada pago por su id, y codespar_wallet lista los asientos de la billetera. Mapear cada evento de dinero al ERP, la entidad y la cuenta correctos, y escribirlo, es tu integración.
Del estado de un pago al asiento en tu ERP.
Un boceto ilustrativo: el agente lee el estado del pago en CodeSpar y tu integración escribe el asiento en el ERP. CodeSpar no escribe en el ERP.
- CodeSpar devuelve el estado del pago y el extracto de la billetera
- Escribir en el ERP es tu integración
- Bling se enruta solo para emitir NFS-e
La conversación es la parte fácil.
Cada transacción se carga en un ERP a mano y luego se concilia a fin de mes entre países y entidades.
Cargar cada transacción en el ERP
Tu integración escribe el asiento a partir del estado del pago
Revisar en el portal del banco qué se liquidó
codespar_pay action=status lee cada pago
Rearmar los movimientos de la billetera para el contador
codespar_wallet action=statement los lista
Adjuntar el documento fiscal a mano
codespar_invoice lo emite (NFe.io, solo en proyectos live); adjuntarlo es tu integración
Una propuesta, sobre los registros que existen.
Tu integración lee lo que registra CodeSpar: el estado de un pago por su id (codespar_pay, action=status) y los asientos de la billetera (codespar_wallet, action=statement). Mapea cada asiento a la entidad, la cuenta y la moneda del ERP correcto y lo escribe ahí. CodeSpar no tiene un conector de ERP que escriba asientos: Omie y Tiny no se enrutan, y Bling se enruta solo para NFS-e.
codespar_payEstado del pago por su id
CodeSparcodespar_walletLos asientos de la billetera
CodeSparEntidad, cuenta, moneda
El asiento en el ERP
El documento fiscal, si lo hay
Un boceto, no un flujo del producto. codespar_pay con action=status devuelve el estado de un pago en el proveedor por su id; codespar_wallet con action=statement devuelve los asientos de la billetera. Tu integración convierte cada asiento liquidado en un asiento de ERP de la entidad correcta y lo escribe por la API del propio ERP. Ningún conector de CodeSpar escribe en Omie, Bling o Tiny.
El código, y lo que supone.
// Prerequisites: CODESPAR_API_KEY set to a test key (csk_test_…) and a payment // made through codespar_pay. Writing to the ERP is your code: CodeSpar does not // write to Omie, Bling or Tiny. import { CodeSpar } from "@codespar/sdk"; const session = await new CodeSpar().create("user_0000", { preset: "brazilian" }); // what CodeSpar can tell your integration const status = await session.execute("codespar_pay", { action: "status", payment_id: "<payment id>" }); const statement = await session.execute("codespar_wallet", { action: "statement", consumer_id: "user_0000", limit: 20 }); // your integration: map each settled entry to the ERP of the right entity console.log(status.data, statement.data);
Ejemplo con el SDK publicado (@codespar/sdk 0.16.11). Los requisitos están en los comentarios. Compilar no prueba la integración: ejecútalo primero en modo de prueba.
codespar_payaction=status lee el estado de un pago por su id.
codespar_walletaction=statement lista los asientos de la billetera.
Empieza con una clave de prueba.
Las claves de prueba son gratuitas. Abre el sandbox, conecta los proveedores que usa tu proyecto y mira qué herramientas puede llamar antes de construir.