Usar la automatizacion Mis Retenciones con Node.js

Automatizaciones

Mis Retenciones

Esta automatización consulta retenciones y percepciones en el servicio "Mis Retenciones" de ARCA.

Requisitos previos

Para poder usar esta automatización, primero necesitarás:

Integrar Afip SDK en tu proyecto

Nombre

mis-retenciones

Parametros

cuitstring

CUIT a usar en la página de ARCA.

usernamestring

CUIT para loguearse en la página de ARCA. Normalmente es el mismo CUIT que el parámetro 'cuit', pero si administrás una sociedad, el CUIT que usás para loguearte es tu propio CUIT.

passwordstring

Contraseña para loguearse en la página de ARCA.

modestring

Modo de consulta. Opciones: "filter" o "preset".

pageinteger

Número de página (comienza en 0).

sizeinteger

Cantidad de resultados por página.

presetstringOpcional

Preset a usar cuando mode es "preset". Opciones: "percepcion-ganancias", "percepcion-bienes-personales", "retencion-ganancias".

filtersobjectOpcional

Filtros a usar cuando mode es "filter".

descripcionImpuestostring

Descripción de impuesto.

nombreAgentestring

Nombre del agente de retención/percepción.

fechaRetencionDesdestring

Fecha de retención/percepción desde (yyyy-mm-dd).

fechaRetencionHastastring

Fecha de retención/percepción hasta (yyyy-mm-dd).

impuestoRetenidointeger

Código de impuesto retenido.

tipoImpuestostring

Tipo de impuesto. Opción usada actualmente: "IMP".

percepcionesboolean

Incluir percepciones.

retencionesboolean

Incluir retenciones.

Solicitud

import Afip from '@afipsdk/afip.js';

const afip = new Afip({ access_token: 'TU_ACCESS_TOKEN' });

// Aqui deben cambiar los datos por los que correspondan. 
// Esta request de ejemplo incluye todos posibles 
// valores para ejecutar la automatizacion mis-retenciones, 
// puede que algun valor sea opcional.
const data = {
    "cuit": "20111111112",
    "username": "20111111112",
    "password": "contraseña#segura?",
    "mode": "filter",
    "page": 0,
    "size": 10,
    "preset": "percepcion-ganancias"
};

try {
    // Ejecutamos la automatizacion
    const response = await afip.CreateAutomation("mis-retenciones", data, true);

    // Mostramos la respuesta por consola
    console.log(response);
}
catch(error){
    // En caso de error lo mostramos por consola
	console.error(error);
}

Respuesta

{
    "id": "0c31d74f-d672-4677-a00b-7dc865396c69",
    "status": "complete",
    "data": {
        "page": {
            "size": 1,
            "totalElements": 1,
            "totalPages": 1,
            "number": 0
        },
        "total": 628.34,
        "rows": [
            {
                "cuitAgenteRetencion": 30715421700,
                "impuestoRetenido": 217,
                "codigoRegimen": 596,
                "fechaRetencion": "2025-01-02T00:00:00",
                "numeroCertificado": "418692",
                "descripcionOperacion": "PERCEPCION",
                "importeRetenido": 628.34,
                "numeroComprobante": "1812153",
                "fechaComprobante": "2025-01-02T00:00:00",
                "descripcionComprobante": "OTRO COMPROBANTE",
                "fechaIngreso": "2025-02-10T19:44:16",
                "codSeguridad": "0000"
            }
        ]
    }
}