API de balance de prueba
Comenzando
TrueTrack, anteriormente conocido como "BRP RISE", es un programa y una herramienta de diagnóstico e implementación de mejoras de rentabilidad para concesionarios. El programa TrueTrack tiene como objetivo ayudar a los concesionarios a mejorar su rendimiento financiero midiendo sus resultados y proporcionando puntos de referencia con concesionarios similares en su región.
TrueTrack proporciona:
- Tableros, análisis de tendencias e informes detallados para cada departamento.
- Composición de referencia del concesionario personalizable.
- Personal de apoyo que ayuda a mejorar los objetivos del programa TrueTrack y el valor de los datos del concesionario.
TrueTrack proporciona los siguientes beneficios a los empleados del concesionario:
- Reduce el tiempo que se tarda en revisar los datos del concesionario para mostrar lo que realmente importa.
- Supervisa cada departamento sin necesidad de hojas de cálculo o tablas complejas.
- Compara fácilmente cada departamento con una variedad de promedios competitivos detallados.
- Destaca rápidamente las oportunidades de ganancia más significativas dentro de cada departamento.
- Diagnostica cada oportunidad de ganancia para ayudar a elaborar un plan de mejora con los gerentes.
Se puede encontrar más información en el TrueTrack sitio.
La API de Balance de Comprobación permite que su DMS envíe información financiera seleccionada de un concesionario al programa TrueTrack .
❗❗ La API de Balance de Comprobación NO es desarrollada por BRP sino por el socio TrueTrack Jackson Dawson ❗❗
La documentación de la API se proporciona en el portal DCP para fácil acceso, pero Jackson Dawson (JD) la desarrolla, certifica y brinda soporte.
Resumen del negocio
Tema | Descripción |
|---|---|
Alcance | API global para todas las regiones |
Funcionalidades principales |
|
Procesos comerciales compatibles | |
Beneficios para los concesionarios |
|
Beneficios para BRP |
|
Información técnica
Características
Tipo de API | Tipo de DSP | Versión de DCP | Complejidad |
|---|---|---|---|
Obtener datos de BRP | DMS | V3 - Internacional | Baja |
Enviar datos a BRP | CRM | V4 - Norteamérica | Un poco más |
Transacción con BRP | | | Algo más |
Autenticación
La API está usando autenticación OAuth 2.0.
Para obtener tus credenciales, tienes que escribir a support@truetracksolution.com.
Necesitas un token de acceso válido antes de llamar a esta API o debes llamar al endpoint de Autenticación de TrueTrack para obtener uno.
¡El token de acceso es válido por 60 minutos! (3600 segundos)
URL base de autenticación
Prueba | https://qa-api-auth.truetracktest.com |
|---|---|
Producción | https://api-auth.truetracksolution.com |
URL base
Prueba | https://qa-api.truetracktest.com |
|---|---|
Producción | https://api.truetracksolution.com |
Recurso: Datos del Balance de Prueba
Un DMS usa el Datos del Balance de Prueba recurso para enviar los datos financieros del concesionario para el programa TrueTrack.
Representación JSON
{
"dealer_no": "0000123456",
"generated_at": "2023-10-25T17:10:43+00:00",
"first_year_month_available": "2017-01",
"fiscal_year_start_month": 1,
"currency": "USD",
"language": "en",
"manual_report": true,
"user": "cj",
"general_ledger": {
"accounts_hash": "4aed7e591448f28faa89c475edc5b5bb",
"accounts": [
{
"number": "16000",
"description": "Parts & Accessories Inventory",
"category": "asset",
"debit": true
},
{
"number": "22300",
"description": "Loans",
"category": "liability",
"debit": false
},
{
"number": "30000-07",
"description": "Owners Equity",
"category": "equity",
"debit": false
},
{
"number": "44320",
"description": "Sales New BRP PWC",
"category": "revenue",
"debit": false
},
{
"number": "54320",
"description": "Cogs New BRP PWC",
"category": "cost of sales",
"debit": true
},
{
"number": "70000",
"description": "Advertising BRP",
"category": "expense",
"debit": true
}
]
},
"trial_balances": [
{
"year_month": "2023-03",
"accounts_hash": "c60be469e4c79fb36c3daead049d6a2d",
"accounts": [
{
"number": "16000",
"beginning_balance": 1927737.66,
"ending_balance": 1933336.42,
"count": 47119
},
{
"number": "44320",
"beginning_balance": -135044.82,
"ending_balance": -378856.22,
"count": 7
},
{
"number": "54320",
"beginning_balance": 119516.00,
"ending_balance": 338556.00
},
{
"number": "70000",
"beginning_balance": 13271.50,
"ending_balance": 13455.38
}
]
},
{
"year_month": "2023-04",
"accounts_hash": "5dbe84a4f973145a7e7c1e1e61c9173b",
"accounts": [
{
"number": "16000",
"beginning_balance": 1933336.42,
"ending_balance": 1932254.80,
"count": 47165
},
{
"number": "44320",
"beginning_balance": -378856.22,
"ending_balance": -476483.01,
"count": 3
},
{
"number": "54320",
"beginning_balance": 338556.00,
"ending_balance": 426507.00
},
{
"number": "70000",
"beginning_balance": 13455.38,
"ending_balance": 14845.38
}
]
}
]
}Propiedades
Todos los campos numéricos con decimales usan el punto(.) como separador decimal. La coma (,) NO es compatible como separador decimal.
Property | Type | Definition | Notes |
|---|---|---|---|
dealer_no * | string | Dealer number. | Length: 10 |
generated_at * | string | Date/Time the data is generated, in ISO 8601. | Format: yyyy-mm-ddThh:mm:ssZ or yyyy-mm-ddThh:mm:ss+000 |
first_year_month_available * | string | Earliest available month of data. | Format: yyyy-mm Example: “2016-01” |
fiscal_year_start_month * | number | The month that the fiscal year starts. | Format: 1 to 12 |
currency * | string | The currency in which the balance is provided. The available values are listed in the Currency table below. | Length: 3 |
language * | string | Language of account descriptions. See the Languages table below. | Length: 2 |
manual_report * | boolean | True when manually generated by a user, false if generated by the automatic job. | |
user * | string | User identification. Empty string if an automatic job does the submittal. | Max Length: 64 |
general_ledger * | object | Contains the list of accounts found in the general ledger |
|
general_ledger.accounts_hash * | string | The hash of the general ledger accounts array. | Length: 32 |
general_ledger.accounts | List of objects | |
|
general_ledger.accounts. number * | string | The account number. It can't be empty. | Length: 1 to 64 |
general_ledger.accounts. description * | string | A description of the account. It can't be empty. | Length: 1 to 256 |
general_ledger.accounts. category * | string | Enum of account category, one of:
| |
general_ledger.accounts.debit | boolean | True if the account is for debit, false if it's for credit. |
|
trial_balances * | List of objects | |
|
trial_balances.year_month * | string | The month of the trial balance. | Format: yyyy-mm Example: “2023-01” |
trial_balances.accounts_hash * | string | The hash of the trial balance accounts array. | Length: 32 |
trial_balances.accounts * | List of objects | An array of trial balance accounts for the month. |
|
trial_balances.accounts.number * | string | The account number. | Length: 64 |
trial_balances.accounts. beginning_balance * | number | The balance amount at the start of the month. For all profit & loss accounts, the value is 0 for the first month of the fiscal year. | ±99999999.99 |
trial_balances.accounts. ending_balance * | number | The balance amount at the end of the month. | ±99999999.99 |
trial_balances.accounts.count | number | Optional: An associated count based on the type of account. | ±99999999.99 |
Las propiedades en azul y marcadas con un asterisco (*) son obligatorias en el recurso.
Moneda
Organización de Ventas | Moneda |
|---|---|
1010 | CAD |
3020 | USD |
Idiomas
Código | Idioma |
|---|---|
de | Alemán |
en | Inglés |
es | Español |
fi | Finés |
fr | Francés |
it | Italiano |
nl | Neerlandés |
no | Noruego |
pt | Portugués (Brasil) |
sv | Sueco |
Limitaciones y restricciones
Formato de número
Todos los campos numéricos con decimales usan el punto(.) como separador decimal. La coma (,) NO está soportada como separador decimal.
Comprendiendo el Balance de Comprobación
Estructura del Payload
Cada payload enviado contiene dos objetos grandes:
- La lista de cuentas del libro mayor.
- Una lista de balances de comprobación, uno por cada mes enviado.
Libro mayor
Cada envío contiene el listado completo de cuentas del libro mayor, independientemente de si la cuenta tiene un saldo en los balances de comprobación enviados.
En algunos sistemas, las cuentas del libro mayor están marcadas como “inactivas”. Estas cuentas también deben incluirse si la cuenta tiene un saldo en cualquier mes.
👉 Solo se envían las cuentas del libro mayor donde se registran transacciones, a menudo llamadas cuentas detalladas.
Las otras cuentas, como cabecera, consolidadas, totales, resumen, etc., NO se envían.
Balances de comprobación
Cada envío puede incluir múltiples meses de balances de comprobación. Cada mes de balance de comprobación contiene todas las cuentas con un saldo al inicio o al final del mes.
👉 Las cuentas con un saldo cero al inicio y al final del mes no deben incluirse.
En cualquier balance de comprobación enviado, un número positivo significa que la cuenta tiene un saldo deudor, y un número negativo significa que la cuenta tiene un saldo acreedor, independientemente de cuál sea el saldo "normal" de esa cuenta.
Muchos sistemas contables restablecen los saldos en las cuentas de pérdidas y ganancias al inicio de un nuevo año fiscal. La beginning_balance propiedad para todas las cuentas de pérdidas y ganancias en el primer mes del año fiscal debe ser 0.
Hashes
La propiedad accounts_hash en los objetos general_ledger y trial_balances determina si las cuentas han cambiado desde el último envío.
El backend de TrueTrack guarda el valor de accounts_hash recibido en el payload. TrueTrack compara el valor de accounts_hash guardado con el valor de accounts_hash recibido al recibir un payload. Si son iguales, no hubo cambios y los datos no necesitan ser procesados.
👉Todas las propiedades de las cuentas deben incluirse en el hash.
Para el libro mayor, el hash se calcula sobre las siguientes propiedades de todas las cuentas:
- número
- descripción
- categoría
- débito
Para los saldos de prueba, el hash se calcula sobre las siguientes propiedades de todas las cuentas:
- número
- saldo_inicial
- saldo_final
- conteo
El valor hash debe tener 32 caracteres y se calcula utilizando el algoritmo MD5.
La forma exacta en que se calcula el hash no es importante siempre que se incluyan todas las propiedades.
TrueTrack no intentará recalcular el hash 😁
El hash podría calcularse directamente sobre la carga JSON antes de enviarla.
Por ejemplo, el hash podría calcularse sobre el arreglo de cuentas antes de enviar la carga.
El hash también se puede calcular al vuelo mientras se crea la carga útil.
Conteos de Servicio de Calidad (QS)
El objetivo del programa de Servicio de Calidad (QS) de BRP es mejorar la operación de servicio de un concesionario, aumentar los ingresos y las ganancias, y ofrecer una mejor experiencia general al cliente.
Un concesionario en el programa de Servicio de Calidad debe proporcionar servicio y conteos para obtener el beneficio completo de las métricas generadas en TrueTrack.
La propiedad conteo en los datos de la cuenta de balance de prueba proporciona información basada en el uso de la cuenta.
Entrada en TrueTrack
Es posible que su DMS no proporcione una forma para que el concesionario capture los conteos. Si es así, el concesionario puede ingresar los conteos directamente en el sitio de TrueTrack .
Los conteos se pueden ingresar en Herramientas de Datos > Importar Datos haciendo clic en el botón Entrada Rápida para Conteos y Misceláneos en la esquina superior derecha. El concesionario selecciona el mes y año correctos y envía los conteos. Los datos se enviaron mediante la API de Balance de Prueba si sus campos de conteo aparecen en gris.
Conteos del Departamento de Servicio
Dependiendo de cómo el sistema contable del concesionario rastree los ingresos en el departamento de servicio, el concesionario puede tener más o menos conteos para ingresar que los del ejemplo mostrado a continuación.
En este ejemplo, el concesionario ingresó el número de órdenes de reparación (ROs) para las cuentas de Mano de Obra Pagada por el Cliente, Mano de Obra Interna, Reparación Subcontratada y Mano de Obra en Garantía. Como regla, el total de esas líneas será igual al número total de órdenes de reparación (ROs) en el departamento durante el mes.
Algunos concesionarios asignan una cantidad específica de suministros de taller a cada orden de reparación o quizás a las órdenes de reparación que superan un monto establecido en dólares. Por ejemplo, a menos de la mitad de las ROs del concesionario se les asignaron costos de suministros de taller.
Número de empleados
TrueTrack solicita el número de empleados según cómo un concesionario desglosa los costos de nómina. Idealmente, un concesionario registra la nómina del departamento de servicio por separado para Gerente(s) de Servicio, Asesor(es) de Servicio, Técnico(s) de Servicio y todo el demás Personal de Soporte de Servicio, como se muestra en el ejemplo a continuación.
Departamento PA&A
Algunos concesionarios registran PA&A en cuentas separadas del libro mayor, y algunos combinan las categorías. En el ejemplo que se muestra a continuación, el concesionario incluye las ventas de Ropa y Accesorios con las ventas de Piezas.
Resumen de conteos
Uso de cuenta | Cantidad |
|---|---|
Ventas de BRP ATV | Número de unidades vendidas |
COS | No se requiere conteo |
Gasto | No se requiere conteo |
Ventas F&I | Número de facturas vendidas durante el mes |
Inventario | Número de vehículos en inventario al final del mes |
Ventas de repuestos | Número de facturas vendidas durante el mes |
Ventas RO | Número de facturas vendidas durante el mes |
Referencia de la API
curl --location 'https://api-auth.truetracksolution.com/oauth2/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Cookie: XSRF-TOKEN=5a01ec89-9085-437e-a7a8-d0dac11779b4' \
--data-urlencode 'client_id=YOUR_CLIENT_ID' \
--data-urlencode 'client_secret=YOUR_CLIENT_SECRET' \
--data-urlencode 'scope=trial_balance/write' \
--data-urlencode 'grant_type=client_credentials'curl --location 'https://api.truetracksolution.com/trial-balance' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_BEARER_TOKEN' \
--data '{
"dealer_no": "0000123456",
"generated_at": "2023-10-25T17:10:43+00:00",
"first_year_month_available": "2017-01",
"fiscal_year_start_month": 1,
"currency": "USD",
"language": "en",
"manual_report": true,
"user": "cj",
"general_ledger": {
"accounts_hash": "4aed7e591448f28faa89c475edc5b5bb",
"accounts": [
{
"number": "16000",
"description": "Inventory Parts & Accessories",
"category": "asset",
"debit": true
},
{
"number": "22300",
"description": "Loans from Shareholders",
"category": "liability",
"debit": false
},
{
"number": "30000-07",
"description": "Owners Equity",
"category": "equity",
"debit": false
},
{
"number": "44320",
"description": "Sales New BRP SSV",
"category": "revenue",
"debit": false
},
{
"number": "54320",
"description": "Cogs New BRP SSV",
"category": "cost of sales",
"debit": true
},
{
"number": "70000-05",
"description": "Advertising BRP",
"category": "expense",
"debit": true
}
]
},
"trial_balances": [
{
"year_month": "2023-03",
"accounts_hash": "c60be469e4c79fb36c3daead049d6a2d",
"accounts": [
{
"number": "16000",
"beginning_balance": 1927737.66,
"ending_balance": 1933336.42,
"count": 47119
},
{
"number": "44320",
"beginning_balance": -135044.82,
"ending_balance": -378856.22,
"count": 7
},
{
"number": "54320",
"beginning_balance": 119516.00,
"ending_balance": 338556.00
},
{
"number": "70000-05",
"beginning_balance": 13271.50,
"ending_balance": 13455.38
}
]
},
{
"year_month": "2023-04",
"accounts_hash": "5dbe84a4f973145a7e7c1e1e61c9173b",
"accounts": [
{
"number": "16000",
"beginning_balance": 1933336.42,
"ending_balance": 1932254.80,
"count": 47165
},
{
"number": "44320",
"beginning_balance": -378856.22,
"ending_balance": -476483.01,
"count": 3
},
{
"number": "54320",
"beginning_balance": 338556.00,
"ending_balance": 426507.00
},
{
"number": "70000-05",
"beginning_balance": 13455.38,
"ending_balance": 14845.38
}
]
}
]
}
'Cómo hacerlo
Esta sección proporciona información sobre cómo obtener resultados específicos con la API.
Obtener un token de acceso
Obtenga un token de acceso para llamar a la API de Balance de Prueba.
curl --location 'https://api-auth.truetracksolution.com/oauth2/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'client_id=REPLACE_ME_CLIENT_ID' \
--data-urlencode 'client_secret=REPLACE_ME_CLIENT_SECRET' \
--data-urlencode 'scope=trial_balance/write' \
--data-urlencode 'grant_type=client_credentials'Cargar datos del balance de comprobación
Envíe los datos del balance de comprobación del distribuidor para un mes.
curl --location 'https://api.truetracksolution.com' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data '{
"dealer_no": "0000123456",
"generated_at": "2023-10-25T17:10:43+00:00",
"first_year_month_available": "2017-01",
"fiscal_year_start_month": 1,
"currency": "USD",
"language": "en",
"manual_report": true,
"user": "cj",
"general_ledger": {
"accounts_hash": "4aed7e591448f28faa89c475edc5b5bb",
"accounts": [
{
"number": "16000",
"description": "Inventory Parts & Accessories",
"category": "asset",
"debit": true
},
{
"number": "22300",
"description": "Loans from Shareholders",
"category": "liability",
"debit": false
},
{
"number": "30000-07",
"description": "Owners Equity",
"category": "equity",
"debit": false
},
{
"number": "44320",
"description": "Sales New BRP SSV",
"category": "revenue",
"debit": false
},
{
"number": "54320",
"description": "Cogs New BRP SSV",
"category": "cost of sales",
"debit": true
},
{
"number": "70000-05",
"description": "Advertising BRP",
"category": "expense",
"debit": true
}
]
},
"trial_balances": [
{
"year_month": "2023-03",
"accounts_hash": "c60be469e4c79fb36c3daead049d6a2d",
"accounts": [
{
"number": "16000",
"beginning_balance": 1927737.66,
"ending_balance": 1933336.42,
"count": 47119
},
{
"number": "44320",
"beginning_balance": -135044.82,
"ending_balance": -378856.22,
"count": 7
},
{
"number": "54320",
"beginning_balance": 119516.00,
"ending_balance": 338556.00
},
{
"number": "70000-05",
"beginning_balance": 13271.50,
"ending_balance": 13455.38
}
]
}
]
}
'Gestión de errores
Esta sección presenta varios escenarios de llamadas incorrectas o inapropiadas, que resultan en mensajes de error y resultados incorrectos.
400 Solicitud incorrecta
El código de estado 400 generalmente se observa durante el desarrollo y la integración y no debería recibirse durante las operaciones normales. La respuesta devuelta contiene la información necesaria para corregir el problema.
Muchos problemas pueden causar un código de estado 400; los más comunes se enumeran en la tabla a continuación.
Respuesta | Resolución |
|---|---|
Se devuelve si el número de concesionario no es válido. {
"status": "400",
"id": "rrt-07cdd77f98c381924-d-ea-22529-1513654-1",
"title": "solicitud_incorrecta",
"meta": {
"service": "01",
"detail": "falló la validación de la solicitud",
"payload": {
"details": [
{
"message": "La cadena \"22391888\" es demasiado corta (longitud: 8, mínimo requerido: 10): []"
}
]
}
}
} | Si el concesionario está usando tu DMS, es posible que ya no sea un concesionario BRP. Verifícalo con ellos y desactiva las actualizaciones de inventario de repuestos. Asegúrate de que el número de concesionario tenga 10 caracteres. Si estás guardando el número sin ceros a la izquierda, agrega el '0' inicial antes de llamar al API. El error también se devuelve si el concesionario no es un concesionario BRP activo. |
Se devuelve si falta una propiedad. {
"status": "400",
"id": "e090fc8d-1651-42d9-9008-4c1bcb666212",
"title": "solicitud_incorrecta",
"meta": {
"service": "01",
"detail": "Cuerpo de solicitud inválido: [al objeto le faltan propiedades requeridas ([\"fiscal_year_start_month\"])]"
}
} | Agrega la propiedad faltante al payload. |
Se devuelve si una fecha tiene un formato inválido. {
"status": "400",
"id": "0829c7e5-f568-4a04-9c71-0977937d5586",
"title": "solicitud_incorrecta",
"meta": {
"service": "01",
"detail": "Cuerpo de solicitud inválido: [el atributo de formato \"int32\" no es compatible, la cadena \"2023-10-25T17:10:43\" es inválida para el(los) formato(s) de fecha solicitado(s) [yyyy-MM-dd'T'HH:mm:ssZ, yyyy-MM-dd'T'HH:mm:ss.SSSZ]]"
}
} | Cambia el formato de la cadena de fecha para que coincida con el formato del payload. |
Se devuelve si un número tiene un formato inválido.
{
"status": "400",
"id": "fa8fced3-020a-46d5-a2e0-da93bfd9b6c5",
"title": "solicitud_incorrecta",
"meta": {
"service": "01",
"detail": "Cuerpo de solicitud inválido: [la instancia no cumplió con todos los esquemas requeridos (coincidió solo 0 de 1), el atributo de formato \"int32\" no es compatible]"
}
}
| Todos los importes en el payload tienen un formato de ±9999999.99. Cambia el formato de la propiedad para que coincida con el payload. |
401 No autorizado
El código de estado de error 401 Unauthorized se devuelve cuando intentas llamar a la API de Balance de Prueba con un access_token expirado.
Debes obtener un nuevo access_token con una llamada al endpoint de Autenticación de Balance de Prueba.
El código de estado de error 401 Unauthorized también se devuelve si no solicitaste acceso a la API enviando un correo electrónico a [email protected].
Requisitos de DSP
Requisitos funcionales
ID | Tipo | Requisito |
|---|---|---|
1 | Obligatorio | El concesionario debe poder enviar manualmente los datos del balance de prueba. |
2 | Obligatorio | El concesionario debe poder enviar manualmente los datos del balance de prueba de un mes tantas veces como desee. |
3 | Obligatorio | El concesionario tiene las siguientes opciones para enviar los datos del balance de prueba:
|
4 | Obligatorio | El DMS debe establecer la propiedad user con un identificador de la persona que realiza el envío manual, preferiblemente la dirección de correo electrónico. |
5 | Obligatorio | La propiedad beginning_balance para todas las cuentas de pérdidas y ganancias debe ser 0 para el primer mes del año fiscal. |
6 | Obligatorio | Si está disponible, se deben enviar 5 años de datos históricos cuando el concesionario se une al programa TrueTrack . |
7 | Opcional | El concesionario debe poder activar cargas automáticas de los datos del balance de prueba. |
8 | Opcional | Cuando la carga automática está activa, los datos del balance de prueba deben enviarse según el siguiente calendario:
|
Actividades de Certificación
Esta sección presenta todas las actividades de certificación y validaciones que deben completarse para certificar la API.
Validaciones
Las pruebas enumeradas en la tabla a continuación deben realizarse con éxito en el entorno de pruebas antes de iniciar la fase piloto con el distribuidor.
👉 En todas las pruebas, debe proporcionar un informe que liste las cuentas y los datos de balance de comprobación. El informe se utilizará para validar los datos de balance de comprobación recibidos.
El informe puede proporcionarse en PDF, Excel o CSV.
Para todas las pruebas, se realizan las siguientes validaciones:
- Se incluyen todas las cuentas, incluso si no tienen saldo.
- Comparar saldos versus el balance de comprobación exportado (hoja de cálculo, PDF, etc.).
- El primer mes del año fiscal
- El último mes del año fiscal
- Mes en el medio
ID | Prueba | Resultado Esperado |
|---|---|---|
1 | Enviar manualmente los datos de la balanza de comprobación del mes actual. | Los datos enviados son válidos. |
2 | Enviar manualmente los datos de la balanza de comprobación de todos los meses de un año calendario completo. | Los datos enviados son válidos. Validar que la propiedad del libro mayor general accounts_hash NO ha cambiado. |
3 | Enviar manualmente los datos de la balanza de comprobación de todos los meses del año fiscal actual. | Los datos enviados son válidos. |
4 | Enviar manualmente los datos de la balanza de comprobación de todos los meses del año fiscal anterior. | Los datos enviados son válidos. |
5 | Cambiar la descripción de una cuenta y enviar los datos de la balanza de comprobación del mes actual. | Los datos enviados son válidos. Validar que la propiedad del libro mayor general accounts_hash ha cambiado. |
6 | Cambiar algunos saldos de cuentas. Si se implementa el envío automático, | Los datos enviados son válidos. Validar que la propiedad de la balanza de comprobación accounts_hash ha cambiado. |
7 | Si se implementa el envío automático, ejecutar los trabajos el tiempo suficiente para realizar los envíos diarios y semanales. | Los datos enviados son válidos. La propiedad manual_report es false. |
Piloto del Distribuidor
La siguiente tabla describe los parámetros y validaciones del piloto de distribuidores.
Parámetro | Valor |
|---|---|
Entorno | Producción |
Número de distribuidores | 1 a 3 |
Duración | 3 semanas |
Validación 1 | Si se utiliza el envío manual, el distribuidor debe enviar sus datos de balance de prueba al menos cada 2 días durante la fase piloto. |
Validación 2 | Si se utiliza el envío automático, los datos del balance de prueba deben enviarse diariamente durante la fase piloto. |
Postman
Esta sección describe lo que está disponible en Postman para explorar la API.
Entornos
Un entorno de Postman está disponible para probar la API de Balance de Prueba. Este entorno de Postman contiene variables utilizadas por las consultas y está configurado para conectarse al entorno de prueba.
Colecciones
La colección DMS - Balance de Prueba contiene ejemplos de llamadas a la API para cargar datos de balances de prueba.