{"id":36499350,"url":"https://github.com/ralcorta/arcasdk","last_synced_at":"2026-01-13T11:22:12.696Z","repository":{"id":62385782,"uuid":"551715362","full_name":"ralcorta/arcasdk","owner":"ralcorta","description":"SDK para los Web Services de AFIP","archived":false,"fork":false,"pushed_at":"2026-01-07T19:36:02.000Z","size":5834,"stargazers_count":76,"open_issues_count":8,"forks_count":20,"subscribers_count":6,"default_branch":"main","last_synced_at":"2026-01-12T04:49:39.972Z","etag":null,"topics":["afip","afip-js","afip-sdk","afip-ts","api","argentina","cae","contribuyente","facturacion-electronica","javascript","libreria","nodejs","package","programacion","rest","sdk","soap","typescript","webservice","wsaa"],"latest_commit_sha":null,"homepage":"https://www.afipts.com/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ralcorta.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-10-15T00:20:58.000Z","updated_at":"2026-01-07T16:58:50.000Z","dependencies_parsed_at":"2024-04-06T23:24:53.205Z","dependency_job_id":"bf8e6995-7d3b-43b2-b263-9cb56ba76eb1","html_url":"https://github.com/ralcorta/arcasdk","commit_stats":{"total_commits":90,"total_committers":3,"mean_commits":30.0,"dds":"0.16666666666666663","last_synced_commit":"c1c29defc72555dad57602693b17254ef490bb76"},"previous_names":[],"tags_count":25,"template":false,"template_full_name":null,"purl":"pkg:github/ralcorta/arcasdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ralcorta%2Farcasdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ralcorta%2Farcasdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ralcorta%2Farcasdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ralcorta%2Farcasdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ralcorta","download_url":"https://codeload.github.com/ralcorta/arcasdk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ralcorta%2Farcasdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28384017,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T10:34:27.190Z","status":"ssl_error","status_checked_at":"2026-01-13T10:34:26.289Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["afip","afip-js","afip-sdk","afip-ts","api","argentina","cae","contribuyente","facturacion-electronica","javascript","libreria","nodejs","package","programacion","rest","sdk","soap","typescript","webservice","wsaa"],"created_at":"2026-01-12T02:16:58.851Z","updated_at":"2026-01-13T11:22:12.669Z","avatar_url":"https://github.com/ralcorta.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003e ### ⚠️ AVISO DE MIGRACIÓN\n\u003e\n\u003e **Este proyecto ha evolucionado de `afip.ts` a Arca SDK.**\n\u003e\n\u003e El repositorio ha sido renombrado y el paquete ahora se publica como [`@arcasdk/core`](https://www.npmjs.com/package/@arcasdk/core).\n\u003e\n\u003e **¿Cómo seguir usando la versión anterior?**\n\u003e El código original de `afip.ts` se encuentra preservado en la rama [`afip.ts`](../../tree/afip.ts) y el paquete sigue disponible en npm como [`afip.ts`](https://www.npmjs.com/package/afip.ts).\n\u003e\n\u003e Todo el desarrollo futuro continuará en la rama `main` bajo el nuevo nombre.\n\n# 🚀 Arca SDK\n\n![TypeScript](https://img.shields.io/badge/typescript-%23007ACC.svg?style=for-the-badge\u0026logo=typescript\u0026logoColor=white)\n\n[![npm](https://img.shields.io/npm/v/@arcasdk/core.svg?style=flat-square)](https://npmjs.org/package/@arcasdk/core)\n![GitHub Repo stars](https://img.shields.io/github/stars/ralcorta/arcasdk)\n![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/ralcorta/arcasdk)\n![GitHub](https://img.shields.io/github/license/ralcorta/arcasdk)\n![npm](https://img.shields.io/npm/dt/@arcasdk/core)\n\n\u003cbr /\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/ralcorta/arcasdk\"\u003e\n    \u003cimg src=\"docs/public/logo.png\" alt=\"arcasdk\" width=\"230\"\u003e\n  \u003c/a\u003e\n\n  \u003ch3 align=\"center\"\u003eArca SDK\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    SDK para consumir y usar los Web Services de ARCA (ex AFIP)\n    \u003cbr /\u003e\n    \u003ca href=\"https://ralcorta.github.io/arcasdk\"\u003eVer documentacion completa\u003c/a\u003e\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003csmall\u003e \n        Inspirado en \u003ca href=\"https://github.com/AfipSDK/afip.js\"\u003eafip.js\u003c/a\u003e \n      \u003cbr /\u003e\n      \u003ca href=\"https://github.com/ralcorta/arcasdk/issues\"\u003eReportar un bug\u003c/a\u003e\n    \u003c/small\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\n\u003cbr /\u003e\n\u003cp align=\"center\"\u003e\n\u003ca href='https://cafecito.app/rodrigoalcorta' rel='noopener' target='_blank'\u003e\u003cimg srcset='https://cdn.cafecito.app/imgs/buttons/button_5.png 1x, https://cdn.cafecito.app/imgs/buttons/button_5_2x.png 2x, https://cdn.cafecito.app/imgs/buttons/button_5_3.75x.png 3.75x' src='https://cdn.cafecito.app/imgs/buttons/button_5.png' alt='Invitame un café en cafecito.app' /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## Guia\n\n### Instalación\n\n##### NPM\n\n```sh\nnpm i @arcasdk/core --save\n```\n\n##### Yarn\n\n```sh\nyarn add @arcasdk/core\n```\n\n### Uso de la SDK\n\n##### Requisitos previos\n\nSe debe tener los certificados emitidos por ARCA/AFIP, ya sean para los servidores de homologacion (test) o produccion, para poder pasarselos como parametro al paquete y que este haga uso de ellos para comunicarse con los web services.\n\n- [Guia de como obtenerlos](https://ralcorta.github.io/arcasdk/tutorial/enable_testing_certificates.html)\n- [Documentacion oficial de certificados](https://www.afip.gob.ar/ws/documentacion/certificados.asp)\n\n##### Ejemplo basico\n\nEjemplo de como generar factura electronica:\n\n```ts\nimport { Arca } from \"@arcasdk/core\";\n\nconst arca: Arca = new Arca({\n  key: \"private_key_content\",\n  cert: \"crt_content\",\n  cuit: 20111111112,\n});\n\nconst date = new Date(Date.now() - new Date().getTimezoneOffset() * 60000)\n  .toISOString()\n  .split(\"T\")[0];\n\nconst payload = {\n  CantReg: 1, // Cantidad de comprobantes a registrar\n  PtoVta: 1, // Punto de venta\n  CbteTipo: 6, // Tipo de comprobante (ver tipos disponibles)\n  Concepto: 1, // Concepto del Comprobante: (1)Productos, (2)Servicios, (3)Productos y Servicios\n  DocTipo: 99, // Tipo de documento del comprador (99 consumidor final, ver tipos disponibles)\n  DocNro: 0, // Número de documento del comprador (0 consumidor final)\n  CbteDesde: 1, // Número de comprobante o numero del primer comprobante en caso de ser mas de uno\n  CbteHasta: 1, // Número de comprobante o numero del último comprobante en caso de ser mas de uno\n  CbteFch: parseInt(date.replace(/-/g, \"\")), // (Opcional) Fecha del comprobante (yyyymmdd) o fecha actual si es nulo\n  ImpTotal: 121, // Importe total del comprobante\n  ImpTotConc: 0, // Importe neto no gravado\n  ImpNeto: 100, // Importe neto gravado\n  ImpOpEx: 0, // Importe exento de IVA\n  ImpIVA: 21, //Importe total de IVA\n  ImpTrib: 0, //Importe total de tributos\n  MonId: \"PES\", //Tipo de moneda usada en el comprobante (ver tipos disponibles)('PES' para pesos argentinos)\n  MonCotiz: 1, // Cotización de la moneda usada (1 para pesos argentinos)\n  CondicionIVAReceptorId: 1, // Condición de IVA del receptor\n  Iva: [\n    // (Opcional) Alícuotas asociadas al comprobante\n    {\n      Id: 5, // Id del tipo de IVA (5 para 21%)(ver tipos disponibles)\n      BaseImp: 100, // Base imponible\n      Importe: 21, // Importe\n    },\n  ],\n};\n\nconst invoice = await arca.electronicBillingService.createInvoice(payload);\n```\n\nEjemplo de otros endpoints:\n\n```ts\nconst points = await arca.electronicBillingService.getSalesPoints();\n```\n\n## Caracteristicas\n\nToda configuracion del package es pasada por el constructor de la clase `Arca` la cual recibe [Context](https://www.arcasdk.com/guide/config.html).\n\nCaracteristicas:\n\n- Escrito enteramente con `Typescript`\n- Soporte para `Serverless`. El package permite manejar los token de autenticacion de manera aislada.\n\nPara mas \u003cstrong\u003edocumentacion\u003c/strong\u003e, ir al [sitio oficial](https://ralcorta.github.io/arcasdk).\n\n## Desarrollo y contribuciones\n\n### Contribuciones\n\nSi encontras un bug o desaes sugerir algo, revisa de que no haya [issues](https://github.com/ralcorta/arcasdk/issues) con el mismo tema, y de ser asi [puedes generar uno aqui](https://github.com/ralcorta/arcasdk/issues/new).\n\n### Desarrollo\n\nSeria genial si puedes ayudarnos mejorando `arcasdk`. ¿Como hacer?\n\n1. [Clonar](https://github.com/ralcorta/arcasdk).\n\n2. `npm install`.\n\n3. Rompela escribiendo tu codigo.\n\n4. Correr los test: `npm test`.\n\n5. Cear un [Pull Request](https://github.com/ralcorta/arcasdk/compare).\n\n## Licencia\n\nEste proyecto esta bajo la licencia `MIT` - Ver [LICENSE](LICENSE) para mas detalles.\n\n\u003csmall\u003e\nEste software y sus desarrolladores no tienen ninguna relación con la ARCA/AFIP.\n\u003c/small\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fralcorta%2Farcasdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fralcorta%2Farcasdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fralcorta%2Farcasdk/lists"}