Facturear

Facturear Importar desde ARCA API

Traer a Facturear los comprobantes que ARCA ya autorizó

GitHub OpenAPI

Operations 4

GET /arca-imports Último relevamiento de un CUIT #
POST /arca-imports Relevar los comprobantes de ARCA #
POST /arca-imports/{importId} Avanzar un relevamiento #
GET /arca-imports/vouchers Comprobantes importados desde ARCA #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/facture-ar/openapi/facture-ar-importar-desde-arca-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/facture-ar/json-schema/facture-ar-arca-import-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/facture-ar:facture-ar-importar-desde-arca-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

facture-ar-importar-desde-arca-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Facturear Importar desde ARCA API
  description: 'API para emitir facturas electrónicas de ARCA (Argentina) desde tu sistema: facturas, notas de crédito y débito, lotes, PDF y XML, envío por email, borradores desde documentos, webhooks y reportes. Autenticación con API Key en el header x-api-key: la key de testing opera en homologación y la de producción emite comprobantes reales.'
  version: 1.0.0
  contact:
    name: Facturear Support
    email: support@facture.ar
    url: https://facture.ar
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
- url: https://www.facture.ar/api
  description: Servidor de producción
security:
- apiKey: []
tags:
- name: Importar desde ARCA
  description: Traer a Facturear los comprobantes que ARCA ya autorizó
paths:
  /arca-imports:
    get:
      summary: Último relevamiento de un CUIT
      description: El relevamiento más reciente del CUIT en el entorno de la API key, o null.
      tags:
      - Importar desde ARCA
      parameters:
      - name: cuitId
        in: query
        description: ID del CUIT en Facturear
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Relevamiento
          content:
            application/json:
              schema:
                type: object
                properties:
                  job:
                    oneOf:
                    - $ref: '#/components/schemas/ArcaImport'
                    - type: 'null'
        '400':
          description: Falta cuitId
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: CUIT no encontrado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      operationId: getArcaImports
      x-operation-id-source: derived
    post:
      summary: Relevar los comprobantes de ARCA
      description: Empieza a relevar los comprobantes que ARCA ya autorizó para el CUIT en el período. Si ya hay un relevamiento en curso, lo devuelve. Cuando llega a status ready, importalo con la acción start.
      tags:
      - Importar desde ARCA
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - cuitId
              - range
              properties:
                cuitId:
                  type: string
                range:
                  type: string
                  enum:
                  - mes
                  - anio
                  - anio-pasado
                  description: 'mes: desde principio de mes; anio: desde principio de año; anio-pasado: el año pasado'
      responses:
        '200':
          description: Relevamiento
          content:
            application/json:
              schema:
                type: object
                properties:
                  job:
                    oneOf:
                    - $ref: '#/components/schemas/ArcaImport'
                    - type: 'null'
        '400':
          description: Falta el CUIT o el período
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: CUIT no encontrado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: La importación no está disponible en este momento
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      operationId: postArcaImports
      x-operation-id-source: derived
  /arca-imports/{importId}:
    post:
      summary: Avanzar un relevamiento
      description: 'start: importa lo relevado (status ready); retry: reintenta uno con error; cancel: lo cancela; resume: lo retoma si quedó parado.'
      tags:
      - Importar desde ARCA
      parameters:
      - name: importId
        in: path
        description: ID del relevamiento
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - action
              properties:
                action:
                  type: string
                  enum:
                  - start
                  - retry
                  - cancel
                  - resume
      responses:
        '200':
          description: Relevamiento
          content:
            application/json:
              schema:
                type: object
                properties:
                  job:
                    oneOf:
                    - $ref: '#/components/schemas/ArcaImport'
                    - type: 'null'
        '400':
          description: Acción desconocida
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: No se encontró la importación
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      operationId: postArcaImportsByImportId
      x-operation-id-source: derived
  /arca-imports/vouchers:
    get:
      summary: Comprobantes importados desde ARCA
      description: Los comprobantes del CUIT importados desde ARCA (origin arca), los más recientes primero. Devuelve hasta 100 y el total.
      tags:
      - Importar desde ARCA
      parameters:
      - name: cuitId
        in: query
        description: ID del CUIT en Facturear
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Comprobantes
          content:
            application/json:
              schema:
                type: object
                properties:
                  vouchers:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: ID de la factura en Facturear
                        issuedAt:
                          type: string
                          format: date-time
                        typeName:
                          type: string
                        number:
                          type: string
                          description: Punto de venta y número, por ejemplo 0001-00000145
                        receiver:
                          type: string
                        amount:
                          type: number
                        moneda:
                          type: string
                  total:
                    type: integer
        '400':
          description: Falta cuitId
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: CUIT no encontrado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      operationId: getArcaImportsVouchers
      x-operation-id-source: derived
components:
  schemas:
    ArcaImport:
      type: object
      description: Un relevamiento de los comprobantes que ARCA ya autorizó para un CUIT, y su importación a Facturear
      properties:
        id:
          type: string
        status:
          type: string
          enum:
          - scanning
          - ready
          - importing
          - done
          - error
          - cancelled
          description: 'scanning: relevando; ready: relevado, listo para importar; importing: importando; done, error o cancelled'
        range:
          type: string
          enum:
          - mes
          - anio
          - anio-pasado
        rangeLabel:
          type: string
        from:
          type:
          - string
          - 'null'
          description: Primer día incluido (DD/MM/AAAA)
        to:
          type:
          - string
          - 'null'
          description: Último día incluido (DD/MM/AAAA)
        imported:
          type: integer
        skipped:
          type: integer
        gaps:
          type: integer
        errorMessage:
          type:
          - string
          - 'null'
        updatedAt:
          type: string
          format: date-time
        pointsOfSale:
          type: array
          items:
            type: integer
        segments:
          type: array
          description: Un tramo por punto de venta y tipo de comprobante
          items:
            type: object
            properties:
              ptoVta:
                type: integer
              cbteTipo:
                type: integer
              cbteTipoName:
                type: string
              lastNumber:
                type: integer
              fromNumber:
                type:
                - integer
                - 'null'
              toNumber:
                type:
                - integer
                - 'null'
              fromDate:
                type:
                - string
                - 'null'
              toDate:
                type:
                - string
                - 'null'
              inRange:
                type: integer
              already:
                type: integer
                description: Ya estaban en Facturear
              pending:
                type: integer
              note:
                type:
                - string
                - 'null'
              resolved:
                type: boolean
        totals:
          type: object
          properties:
            inRange:
              type: integer
            already:
              type: integer
            pending:
              type: integer
        scan:
          type:
          - object
          - 'null'
          description: Avance del relevamiento; null cuando terminó
          properties:
            phase:
              type: string
              enum:
              - puntos
              - numeracion
              - fechas
            done:
              type: integer
            total:
              type: integer
        cursor:
          type:
          - object
          - 'null'
          description: Por dónde va la importación
          properties:
            ptoVta:
              type: integer
            cbteTipoName:
              type: string
            next:
              type: integer
            toNumber:
              type: integer
    Error:
      type: object
      description: Error de la API. Los errores de autenticación (401), validación (400), CUIT inexistente (404), conflicto (409) e internos (500) vienen como application/problem+json (RFC 9457) con code, message y resolution. Otros errores vienen como JSON con error y, a veces, details y code. En los dos casos está el campo error.
      required:
      - error
      properties:
        error:
          type: string
          description: Mensaje de error
        code:
          type: string
          description: 'Código estable: unauthorized, invalid_request, cuit_not_found, conflict, internal_error, o códigos propios como SUBSCRIPTION_LIMIT_EXCEEDED'
        message:
          type: string
          description: Qué pasó (problem+json)
        resolution:
          type: string
          description: Qué hacer para resolverlo (problem+json)
        type:
          type: string
          format: uri
          description: URI del tipo de problema (problem+json)
        title:
          type: string
          description: Título corto del problema (problem+json)
        status:
          type: integer
          description: Código HTTP (problem+json)
        detail:
          type: string
          description: Igual que message (problem+json)
        details:
          description: 'Detalle del error: un texto, o la lista de errores de validación'
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: 'API Key para autenticación. Formato: test_sk_xxx para testing, prod_sk_xxx para producción.'