Saltar al contenido principal
Documentación
Documentación
Adaptive Planning
Última actualización: 2023-06-23
Cuentas

Cuentas

Versión: v1

VERB HTTP admitidos

HTTP Verb
Descripción
POST
Elimine las cuentas mencionadas en la solicitud.

POST:

Solicitud:
/removeGLAccounts:
Elimina las cuentas de los códigos de cuenta de libro mayor especificados.
Este punto final está detrás del indicador de función "
ENABLE_ACCOUNTS_DELETION_JSON_API
" (actualmente activado por defecto).
Admite todas las cuentas de libro mayor que se pueden eliminar en la interfaz de usuario. Ignora las cuentas que no se pueden eliminar.
URI de solicitud de muestra:
https://api.adaptiveplanning.com/api/rest/modeling/v1/globosales/accounts/removeGLAccounts
Cabecera de solicitud de muestra:
Autorización: básica
Tipo de contenido: application/json
Cuerpo de solicitud de muestra
Solicitud POST de muestra 
[
    {
        "accountCodesToDelete": ["Assets", "b"]
    }
]
Parámetros de carga útil
Nombre
Descripción
Obligatorias
accountCodesToDelete
Códigos de cuenta que se eliminarán.
Sí
Parámetro de ruta
Nombre
Descripción
Obligatorias
entorno de cliente
Entorno de cliente en el que operar. p. ej., globosales
Sí
Parámetros de consulta
Nombre
Descripción
Obligatorias
forceRemove
Elimina las cuentas en uso cuando forceRemove=true e ignora las cuentas en uso cuando forceRemove=false.
El valor por defecto siempre es forceRemove=false.
No
instanceCode
El instanceCode de donde se van a recuperar los valores. Por ejemplo, GLOBO. Si no se especifica instanceCode, se utiliza la instancia por defecto del usuario.
No
Ejemplo de respuesta:
204 Sin contenido
La respuesta correcta está en blanco con el código de estado 204.
400 Solicitud incorrecta
El servidor no ha podido entender la solicitud.
401 No autorizado
El usuario no está autorizado.
403 Prohibido
El usuario no tiene suficientes permisos.
500 Error interno de servidor
Error interno de servidor.

POST:

Solicitud:
/removeAccounts
Elimina las cuentas de los códigos de cuenta de libro mayor especificados.
Este punto final está detrás del indicador de función "
ENABLE_ACCOUNTS_DELETION_JSON_API_2
" (actualmente desactivado por defecto).
Admite todas las cuentas que se pueden eliminar en la interfaz de usuario. Ignora las cuentas que no se pueden eliminar y puede proporcionar avisos opcionales.
URI de solicitud de muestra:
https://api.adaptiveplanning.com/api/rest/modeling/v1/globosales/accounts/removeAccounts
Cabecera de solicitud de muestra:
Autorización: básica
Tipo de contenido: application/json
Cuerpo de solicitud de muestra
Solicitud POST de muestra 

    {
        "accountCodesToDelete": ["Assets", "b"]
    }
Parámetros de carga útil
Nombre
Descripción
Obligatorias
accountCodesToDelete
Códigos de cuenta que se eliminarán.
Sí
Parámetro de ruta
Nombre
Descripción
Obligatorias
entorno de cliente
Entorno de cliente en el que operar. p. ej., globosales
Sí
Parámetros de consulta
Nombre
Descripción
Valor por defecto
Obligatorias
forceRemove
Elimina las cuentas en uso.
falso
No
showWarnings
Muestra avisos como respuesta.
falso
No
doValidateOnly
Activa el modo de validación.
falso
No
Avisos
account-deletion-warning=Algunas cuentas no se han eliminado.
Warning-default-root=No se puede eliminar la cuenta raíz por defecto.
Warning-sheet-root=No se puede eliminar el grupo raíz de hojas.
Warning-cta-account=No se puede eliminar la cuenta de ajuste de conversión acumulativo.
advertir-in-use=La cuenta en uso no se puede eliminar porque forceRemove está desactivado.
Warning-cannot_delete_mi_system_account=No se puede eliminar la cuenta del sistema de participación minoritaria. Se utiliza en el cálculo de la participación minoritaria para el método de consolidación por integración global.
Warning-cannot_delete_mi_net_ Income_account=No se puede eliminar la cuenta de ingresos netos de participación minoritaria. Se utiliza en el cálculo de la participación minoritaria para el método de consolidación por integración global.
advertir-cannot_delete_mi_account_ancestor=La cuenta no se puede eliminar porque una de sus cuentas descendientes se utiliza en el cálculo de la participación minoritaria para el método de consolidación por integración global.
Warning-delete_child_used_in_breakback-msg=La cuenta no se puede eliminar porque esta cuenta o una de sus descendientes se utiliza en la retrotracción automática.
Warning-cannot_delete_pcm_account=Utilice el gestor de configuración de Planning para eliminar esta cuenta.
advertir-nonexistent-code=Esta cuenta no existe.
Warning-ambiguous-code=Este código lo comparten varias cuentas.
Ejemplo de respuesta:
200 ACEPTAR
 
{
    "total": 0
}
200 OK (con avisos)
 
{
    "total": 0,
    "warning": {
        "info": "Some accounts were not deleted.",
        "warnings": [
            {
                "field": "xyz",
                "warning": "This account does not exist."
            }
        ]
    }
}
400 Solicitud incorrecta
El servidor no ha podido entender la solicitud.
401 No autorizado
El usuario no está autorizado.
403 Prohibido
El usuario no tiene permisos suficientes/el indicador de función está desactivado. 
{
    "error": "Service Unavailable"
}
500 Error interno de servidor
Error interno de servidor.