POST /consulta-nit ​

Descripción ​

Este endpoint permite realizar una consulta a la base de datos de la Superintendencia de Administración Tributaria (SAT) de Guatemala para obtener información asociada a un Número de Identificación Tributaria (NIT).

Método HTTP ​

POST

URL ​

/consulta-nit

Encabezados (Headers) ​

Cuerpo de la solicitud (Body) ​

Ejemplo de solicitud ​

POST /consulta-nit
Headers:
{
  "alias": "alias_emisor",
  "llave": "llave_emisor"
}
Body:
{
  "nit": "6738648"
}

Respuesta ​

Si la solicitud es exitosa, el servidor responderá con el código de estado HTTP 200 y los datos asociados al NIT proporcionado.

Ejemplo de Respuesta ​

{
  "status": 200,
  "data": {
    "nit": "6738648",
    "nombre": "MUÑOZ,CHACON,,LUIS,FERNANDO",
    "mensaje": "",
    "tipo": "NIT"
  }
}

export interface Pokedex {
    status: number;
    data:   Data;
}

export interface Data {
    nit:     string;
    nombre:  string;
    mensaje: string;
    tipo:    string;
}

Códigos de Error ​

• 400 Bad Request: Si los parámetros requeridos no están presentes o no tienen un formato válido.
• 401 Unauthorized: Si las credenciales de autenticación (alias y llave) no son válidas.
• 404 Not Found: Si no se encuentra ninguna información asociada al NIT proporcionado.
• 500 Internal Server Error: Si ocurre un error en el servidor al procesar la solicitud.

Ejemplo de Código en Node.js (Express.js) ​

Router.post('/consulta-nit', async (req, res, next) => {
  try {
    const { headers, body } = req
    const data = await infileController.consultaNit(headers, body)
    return res.json(data)
  } catch (error) {
    throw error
  }
})