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 ARCA. Opcional si guardaste una credencial para este username en el mismo proyecto.

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".

descripcionImpuestostringOpcional

Descripción del impuesto. Si se omite junto con impuestoRetenido, se consultan todos los impuestos.

nombreAgentestringOpcional

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

fechaRetencionDesdestringOpcional

Fecha válida de retención/percepción desde (yyyy-mm-dd). Sin fechas se consulta todo el historial.

fechaRetencionHastastringOpcional

Fecha válida de retención/percepción hasta (yyyy-mm-dd). Sin fechas se consulta todo el historial.

impuestoRetenidointegerOpcional

Código de impuesto retenido. Si se omite junto con descripcionImpuesto, se consultan todos los impuestos.

tipoImpuestostringOpcional

Tipo de impuesto: "IMP" (impositiva), "SS" (seguridad social) o "ADU" (aduanera), en mayúsculas. Por defecto "IMP".

percepcionesbooleanOpcional

Incluir percepciones. Si no se manda ni percepciones ni retenciones, se incluyen ambas.

retencionesbooleanOpcional

Incluir retenciones. Si no se manda ni percepciones ni retenciones, se incluyen ambas.

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"
            }
        ]
    }
}