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¶
🔐 POST - Ambiente Productivo
🚀 https://apis.andreanigloballpack.com/validacioncuit-globallpack/api/v1/ObtenerCupos
🧪 POST - Ambiente de Prueba
🛠️ https://apisqa.andreanigloballpack.com/validacioncuit/api/v1/ObtenerCupos
- 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"
}
]