Saltar a contenido

API Cupo (Import Quota)

Descripción

La API validacion de cupo, permite validar si el cuit/cuil tiene cupo disponible y si es un CUIT/CUIL valido.

POST

ObtenerCupos

Endpoint

  • Esta API permite obtener la informacion del comitente.

Request

  • Campo obligatorio: "numeroDocumentoConsignatario" (CUIT/CUIL del comitente)
{
  "tipoDocumentoConsignatario": "cuil",
  "numeroDocumentoConsignatario": "99999999999",
  "validarCupo": true,
  "validarNivel3": true,
  "contratoCourrier": "60000000000"
}

ARCA

  • Al recibir el CUIT/CUIL, se valida si tiene 11 caracteres y luego de obtener el token para el padrón, se intenta obtener a la persona a través del servicio de ARCA.
  • Si se trata de una persona física menor de edad, se devuelve únicamente el campo esMayorDeEdad = false, y no se valida el cupo ni el nivel 3.
  • Si no, se obtienen los cupos a través de ARCA y si posee domicilio fiscal electrónico, se puede confirmar que posee nivel 3.

Response

Status 200 (OK)

  • "cuitValido": 0 = invalido, 1 = valido
  • "cantidadCuposDisponibles": cantidad de cupos disponibles del consignatario para poder importar de forma particular. Si es 0, no tiene cupo disponible y el régimen de su envío será general o comercial detallado.
  • "nivel3": true = posee domicilio fiscal electrónico, servicio que permite recibir comunicaciones oficiales de ARCA y es obligatorio para poder utilizar los servicios con clave fiscal.
  • "esMayorDeEdad": true = es mayor de 16 años, false = es menor de edad. En caso de ser menor de edad, no se valida el cupo ni el nivel 3.
{
    "cuitValido": 1,
    "cantidadCuposDisponibles": 5,
    "nivel3": false,
    "esMayorDeEdad": true
}

Status 500 (InternalServerError)

[
    {
        "code": "CUIT_INVALIDO",
        "property": "NumeroDocumentoConsignatario",
        "message": "La longitud del CUIT debe ser exactamente de 11 caracteres."
    }
]

Status 500 (InternalServerError)

[
    {
        "code": "31707",
        "property": "ARCA",
        "message": "Consignatario inexistente"
    }
]