Articles

Acerca de esta Guía

Resumen

La Interfaz de Programación de Aplicaciones de Depósito Directo (API) permite a su aplicación administrar la configuración de Depósito Directo de un empleado.

¿Qué hay de nuevo en esta Guía?

En esta sección, anunciaremos cualquier nueva revisión de la API de Depósito Directo y de esta guía.

Abril de 2020

La siguiente información se revisó en esta guía:

  • En el Capítulo 2-Caso de uso: Recuperando el Depósito Directo de un empleado, dentro de la sección de Respuesta, se agregó un caso de prueba con enlaces de GitHub para un empleado que tenía varias posiciones.
  • En el Capítulo 3-Caso de uso: Actualización del Depósito Directo de un Empleado, dentro de la sección de Respuesta, se agregaron los siguientes casos de prueba con enlaces de GitHub:
    • Se agregó un Depósito Directo con estado Inactivo.
    • Se actualizó el estado de Depósito Directo de Inactivo a Activo.
    • Se actualizó el estado de Depósito Directo de Activo a Inactivo.
    • Se agregó un Depósito Directo para una posición no primaria.
    • Se actualizó un Depósito Directo para una posición no primaria.
    • Actualizó la solicitud y la respuesta para lo siguiente
  • En el Capítulo 3 – Caso de uso: Actualización del Depósito Directo de un empleado, dentro de la sección de Respuesta, se agregó un Depósito Directo cuando un monto de distribución está en blanco.
  • En el Capítulo 6-Problemas y limitaciones conocidos, se eliminaron los siguientes problemas y limitaciones conocidos desde que se realizaron las mejoras:
    • US1293781: La API da una respuesta de 200 cuando se pasa un registro en blanco por una cantidad de distribución
    • US1331908: Recurso incorrecto utilizado en Meta para Código de Opción Prenota
    • US1331919: Falta la validación para el Campo de Fecha Prenota personalizado
    • US1221928: Active un Depósito Directo Inactivo

Versión de producto compatible y Base de clientes

La API de Depósito directo está disponible para los clientes de ADP Workforce Now en los Estados Unidos (EE.UU.) y Canadá con funciones de nómina.

Process Overview

Typical B2B Application Integration Flow

Actor

Task Description

1

Payroll Practitioner

Setup Direct Deposit cuentas en la Fuerza de trabajo de ADP Ahora.

2

Su Aplicación

Utilice el Trabajador de la API de Administración para sincronizar los datos de los empleados entre ADP fuerza de trabajo y su aplicación.

3

Nómina Practicante

En su aplicación, seleccione a un empleado y a iniciar una acción a la vista Depósitos Directos.

4

Su Aplicación

Utilizar el Depósito Directo API para recuperar el Depósito Directo de los datos de configuración para el empleado seleccionado.

5

Nómina Practicante

en su aplicación, En vista de un empleado de Depósito Directo de datos.

6

Nómina Practicante

En su aplicación, la actualización de un empleado de Depósito Directo de datos.

7

Su Aplicación

Utilizar el Depósito Directo de la API para reemplazar el Depósito Directo de los datos de configuración para el empleado seleccionado.

Tras el procesamiento exitoso de la nómina, ADP distribuye automáticamente los fondos del pago del empleado a su cuenta de Depósito Directo según la configuración de Depósito Directo.

Typical B2C Application Integration Flow

Actor

Task Description

1

User

Login to your application.

2

Usuario

la autenticación con el empleador emitido ADP credencial y consentimiento para permitir su aplicación para recuperar el individuo ADP-administrado Depósito Directo de datos para ese empleador.

3

Su Aplicación

Utilizar el Depósito Directo API para recuperar el individuo Depósito Directo de los datos de configuración.

4

User

In your application, view Direct Deposit setup data.

5

User

In your application, update Direct Deposit setup data.

6

Su Aplicación

Utilizar el Depósito Directo de la API para reemplazar el Depósito Directo de los datos de configuración para el usuario bajo el empleador.

Tras el procesamiento exitoso de la nómina, ADP distribuye automáticamente los fondos del pago del empleado a su cuenta de Depósito Directo según la configuración de Depósito Directo.

Pasos de configuración requeridos

En ADP Workforce Ahora, el Depósito directo es un tipo de deducción. La API de Depósito Directo admite todos los códigos de Depósito directo configurados por los clientes. Los clientes deben asegurarse de que los códigos utilizados por su aplicación se agreguen y configuren en la interfaz de usuario (UI) de ADP Workforce Now seleccionando Setup > Herramientas > Tablas de validación > Nómina > Deducciones y Depósitos > Depósitos.

Colección Postman

Postman le permite importar una colección de API, creadas por otros, para que pueda probarlas. Para obtener más información sobre Postman, consulte Realizar su Primera Llamada a la API Con Postman.

Para descargar colecciones de API para la API de Administración de trabajadores de la biblioteca ADP GitHub e importarlas a Postman, vaya a:
Colección de API de depósito directo.

Acerca del depósito directo

El depósito directo es una función bancaria que permite que sus empleados tengan sus cheques de pago completos o una parte de sus cheques de pago depositados automáticamente en una o más cuentas bancarias. Por ejemplo, cuentas como ahorros, cheques, mercados de dinero, cuentas IRA y otras. La configuración de una empresa controla cuántos Depósitos directos se pueden configurar para un empleado. Por ejemplo, la configuración de una empresa puede permitir que los empleados sumen hasta tres Depósitos Directos o hasta 500 Depósitos Directos.

Acerca de la prenotificación

La prenotificación (o prenota) es cuando un banco prueba nuevas cuentas de Depósito Directo antes de realizar depósitos reales. Esto es para asegurarse de que los fondos se depositan en la cuenta correcta. El prenota suele tardar 10 días. Durante el prenota, el banco notificará al empleador si se utilizó un número de ruta o de cuenta no válido. Los empleados continuarán recibiendo un cheque de pago negociable (en vivo) durante el prenota. Después de la nota previa, los Depósitos directos se realizan automáticamente. Debido al proceso de prenota, los cambios realizados en un Depósito Directo normalmente toman uno o dos ciclos de nómina para ejecutarse.

Cuando se actualiza la información bancaria de un empleado, se reinicia el prenota, generalmente durante cinco días. El empleado recibirá un cheque de pago negociable durante este tiempo.
En ADP Workforce Ahora, un cliente puede configurar prenota para Depósito Directo. Una vez configurada, el usuario puede seleccionar ejecutar la nota prenota utilizando una de las siguientes opciones:

  • Company Default – Use la fecha de finalización estándar de la nota prenota de su empresa.
  • Sin Prenota-Omita el prenota y realice el Depósito Directo lo antes posible.
  • Personalizado: Seleccione una fecha de finalización del calendario.

La opción prenota está habilitada solo para los clientes solicitados. Póngase en contacto con ADP para habilitar la opción de prenota para un cliente específico.