Validar NIF en la AEAT

POST https://{entorno}.ticketbaiws.eus/validar-nif/

Permite validar un nif con el censo de la AEAT. Verifactu exige que las facturas para una persona física se emitan con los datos (nombre + apellido + NIF) correctos. Para personas jurídicas con indicar el NIF es suficiente.

PARÁMETROS

nif string obligatorio NIF a validar	12345678Z
nombre string obligatorio únicamente para personas físicas Nombre + apellido para persona física, opcional para personas jurídicas	Juan Martínez

En el caso de personas físicas, existen estos resultados:

IDENTIFICADO: Si el contribuyente se identifica con los datos identificativos aportados. Se devuelven los datos de apellidos y nombre asociados al NIF.
NO IDENTIFICADO-SIMILAR: Si el contribuyente no se identifica con los datos identificativos aportados por diferencias menores en los apellidos y nombre. Se devuelven los datos de apellidos y nombre asociados al NIF.
NO IDENTIFICADO: Si el contribuyente no se identifica con los datos identificativos aportados.

En el caso de entidades, no existe el resultado “No Identificado-Similar” pero se añaden estos dos resultados:

IDENTIFICADO-BAJA: Si el contribuyente se identifica con el NIF aportado y está en estado baja. Se devuelve el NIF actual y su razón social.
IDENTIFICADO-REVOCADO: Si el contribuyente se identifica con el NIF aportado y está en estado baja por revocación del NIF. Se devuelve el NIF actual y su razón social.

POST https://api.ticketbaiws.eus/validar-nif/

$ curl --request POST \
     --url https://api.ticketbaiws.eus/validar-nif/ \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'Token: xxx' \
     --header 'Nif: 00000014Z'
	 --data '
{
    "nif": "12345678Z",
    "nombre": "Juan Martínez"
}'

$ composer require guzzlehttp/guzzle

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.ticketbaiws.eus/validar-nif/', [
  'body' => '{"nif": "12345678Z","nombre": "Juan Martínez"}'
  'headers' => [
    'Accept' => 'application/json',
    'Content-Type' => 'application/json',
    'Token' => 'xxx',
    'Nif' => '00000014Z'
  ],
]);

echo $response->getBody();

$ python -m pip install requests

import requests

url = "https://api.ticketbaiws.eus/validar-nif/"
payload = {
    "nif": "12345678Z",
    "nombre": "Juan Martínez"
}

headers = {"Accept": "application/json", "Token" : "xxx", "Nif" : "00000014Z"}
response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.ticketbaiws.eus/validar-nif/");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Accept: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, '{"nif": "12345678Z","nombre": "Juan Martínez"}');

CURLcode ret = curl_easy_perform(hnd);

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, '{"nif": "12345678Z","nombre": "Juan Martínez"}');

Request request = new Request.Builder()
  .url("https://api.ticketbaiws.eus/validar-nif/")
  .post(body)
  .addHeader("Accept", "application/json")
  .addHeader("Token", "xxx")
  .addHeader("Nif", "00000014Z")
  .build();
  
Response response = client.newCall(request).execute();

{ } Response JSON

HTTP/1.1 200 OK
{
    "result": "OK",
    "return": {
        "nif": "12345678Z",
        "nombre": "MARTINEZ RODRIGUEZ JUAN",
        "resultado": "IDENTIFICADO"
    },
    "msg": ""
}

Validar NIF en la AEAT

Métodos TicketBAI / Verifactu

Métodos específicos para Verifactu

Métodos específicos para BATUZ BIZKAIA

Otros métodos