Tax Regime Extended

Description

The Argentina Tax Regime Extended service returns the fiscal status of a taxpayer in Argentina: income tax, VAT, monotax, whether the taxpayer integrates a company or is an employer, and the monotax activity. It also returns the registered address and the tax-regime attributes that are not part of that status: economic activity, the date and type of the fiscal situation, and the monotax periods. Each period, when present, includes type, startDate, endDate and code. singleTaxPeriods.totalCount is the number of periods.

The service uses the taxpayer's CUIT as the primary identifier.

Field values

taxpayerStatus

CODE	DESCRIPTION
ACTIVE	Income tax is other than Not registered or Does not apply, or VAT is other than Not registered or Not reached.
INACTIVE	Income tax is missing, Not registered or Does not apply, and VAT is missing, Not registered or Not reached.

incomeTax

CODE	DESCRIPTION
NI	Not registered
AC	Active
EX	Exempt
NC	Does not apply

vat

CODE	DESCRIPTION
NI	Not registered
AC	Active
EX	Exempt
NA	Not reached
XN	Exempt, not reached
AN	Active, not reached

monotributo

CODE	DESCRIPTION
A	Category A
B	Category B
C	Category C
D	Category D
E	Category E
F	Category F
G	Category G
H	Category H
I	Category I
J	Category J
K	Category K
BT	Category B, promoted worker
AP	Category A, primary activity
AC	Category A, cooperative member
AL	Category A, social monotax, lease
AV	Category A, social monotax, sales
AT	Category A, promoted worker
NI	Not registered

category repeats the code when it is a single letter from A to K. For every other code, category is null.

isCompanyPartner

CODE	DESCRIPTION
true	Active
false	Not active

true when the taxpayer integrates a company.

isEmployer

CODE	DESCRIPTION
true	Active
false	Not active

true when the taxpayer is an employer.

monotributoActivity

CODE	DESCRIPTION
00	Not a monotax payer
01	Commercial
02	Professional
03	Services or trade
04	Industrial
05	Agricultural
06	Other
07	Occasional
08	Service provision or lease
09	Other activities
10	Sales
11	Family agriculture

HTTP method GET

Endpoint

https://api.msla-id.com/experience-idv-taxes-api-v1/api/idv-govcheck/v1/ar-identity/tax-regime-extended

[SANDBOX Environment]

For testing purposes, use the base domain: apidev.msla-id.com

Request header parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Authorization	✅	string	bearer jwt token

Query request parameter

NAME	REQUIRED	TYPE	DESCRIPTION	EXAMPLE
CUIT	✅	string	Argentina tax identification number (11 digits).	30500001735

Status code responses

Code	Description
200	OK
400	Bad request — IDV-3001
401	Unauthorized
403	Forbidden — IDV-1004
404	Not found — IDV-1002 Data not found.
500	Internal server error — IDV-1008
504	Gateway timeout — IDV-1100

The full documentation error codes can be found here.

Response 200 status code

{
    "traceId": "34372f63ac42d547",
    "timestamp": "2024-10-17 12:04:00",
    "data": {
        "taxId": "30500001735",
        "name": "BANCO DE GALICIA Y BUENOS AIRES S.A.",
        "taxpayerStatus": "ACTIVE",
        "incomeTax": {
            "code": "AC",
            "description": "Active"
        },
        "vat": {
            "code": "AC",
            "description": "Active"
        },
        "monotributo": {
            "code": "NI",
            "description": "Not registered",
            "category": null
        },
        "isCompanyPartner": false,
        "isEmployer": true,
        "monotributoActivity": {
            "code": "00",
            "description": "Not a monotax payer"
        },
        "fiscalStatusDate": null,
        "fiscalDataType": null,
        "activity": null,
        "activityCode": null,
        "activityCategory": null,
        "activitySubcategory": null,
        "address": {
            "street": null,
            "city": null,
            "state": null,
            "postalCode": null
        },
        "singleTaxPeriods": {
            "data": [],
            "totalCount": 0
        }
    }
}

Each item in singleTaxPeriods.data, when present, has type, startDate, endDate and code.

Response 400 status code

{
    "traceId": "542fc743fffda052",
    "timestamp": "2023-05-05 11:20:46",
    "code": "IDV-3001",
    "message": "Bad request - Invalid or incomplete input data",
    "data": null
}

Response 403 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1004",
    "message": "Forbidden",
    "data": null
}

Response 404 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1002",
    "message": "Data not found."
}

Response 500 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1008",
    "message": "Error in the source of origin, please contact an administration.",
    "data": null
}

Response 504 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1100",
    "message": "Gateway Timeout",
    "data": null
}