API > Completar factura simplificada

TicketBAI - Completar factura simplificada

POST  https://{entorno}.ticketbaiws.eus/tbai-completar/

Este método permite convertir una o varias facturas simplificadas en una factura completa. La factura completa deberá llevar su propio número. No se trata de una factura rectificativa aunque se trate como si fuera una de sustitución

PARÁMETROS

fecha string obligatorio
Fecha de la factura completa en formato dd/mm/yyyy		13/11/2021
hora string obligatorio
Hora de emisión de la factura completa en formato HH:MM:SS		12:14:00
nif string obligatorio
NIF del cliente al que se le emite la factura		B01000012
pais_cliente string opcional
Código 2 letras del país del cliente si el NIF del cliente es extranjero (formato ISO-3166 Alpha-2 code)		ES
nombre string obligatorio
Nombre social del cliente al que se le emite la factura		Empresa de ejemplo S.L.
direccion string obligatorio
Dirección de facturación del cliente al que se le emite la factura		Calle de ejemplo 123
cp string obligatorio
Código postal del cliente al que se le emite la factura		12:14:00
serie string obligatorio
Serie de la factura completa
A
numero string obligatorio
Número de la factura completa
2021000123
simplificadas object array obligatorio (máx 100)
serie string obligatorio
Serie de la factura simplificada		A
numero string obligatorio
Número de factura simplificada		2021000100
fecha string obligatorio
Fecha de la factura que se está rectificando en formato dd/mm/yyyy		13/11/2021
intracomunitaria boolean opcional
Es factura intracomunitaria		false
exportacion boolean opcional
Es factura de exportación a fuera de la comunidad		false

POST https://{entorno}.ticketbaiws.eus/tbai-completar/ 
$ curl --request POST \
     --url https://api-test.ticketbaiws.eus/tbai-completar/ \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'Token: xxx' \
     --header 'Nif: 00000014Z'
	 --data '
{
    "fecha": "13\/11\/2021",
    "hora": "12:14:00",
    "pais_cliente": "ES",
	"nif": "B00000011",
    "nombre": "Empresa de ejemplo S.L.",
    "direccion": "Calle Falsa 123",
    "cp": "28080",
    "serie": "A",
    "numero": "2021000123",
    "simplificadas" : [
        {
            "serie": "A",
            "numero": "20210000075",
            "fecha": "10\/11\/2021"
        },
        {
            "serie": "A",
            "numero": "20210000076",
            "fecha": "10\/11\/2021"
        }
    ],
    "intracomunitaria": false,
	"exportacion": false
}'
$ composer require guzzlehttp/guzzle
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api-test.ticketbaiws.eus/tbai-completar/', [
  'body' => '{"fecha":"13\/11\/2021","hora":"12:14:00","nif":"B00000011","nombre":"Empresa de ejemplo S.L.","direccion":"Calle Falsa 123","cp":"28080","serie":"A-","numero":"2021000123","intracomunitaria":false,"simplificadas":[{"serie":"A","numero": "20210000075","fecha": "10\/11\/2021"}]}',
  '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-test.ticketbaiws.eus/tbai-completar/"
payload = {
    "fecha": "13\/11\/2021",
    "hora": "12:14:00",
    "pais_cliente": "ES",
	"nif": "B00000011",
    "nombre": "Empresa de ejemplo S.L.",
    "direccion": "Calle Falsa 123",
    "cp": "28080",
    "serie": "A",
    "numero": "2021000123",
    "simplificadas" : [
        {
            "serie": "A",
            "numero": "20210000075",
            "fecha": "10\/11\/2021"
        }
    ],
    "intracomunitaria": false,
	"exportacion": false
}

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-test.ticketbaiws.eus/tbai-completar/");

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, '{"fecha":"13\/11\/2021","hora":"12:14:00","nif":"B00000011","nombre":"Empresa de ejemplo S.L.","direccion":"Calle Falsa 123","cp":"28080","serie":"A-","numero":"2021000123","intracomunitaria":false,"simplificadas":[{"serie":"A","numero": "20210000075","fecha": "10\/11\/2021"}]}');

CURLcode ret = curl_easy_perform(hnd);
OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, '{"fecha":"13\/11\/2021","hora":"12:14:00","nif":"B00000011","nombre":"Empresa de ejemplo S.L.","direccion":"Calle Falsa 123","cp":"28080","serie":"A-","numero":"2021000123","intracomunitaria":false,"simplificadas":[{"serie":"A","numero": "20210000075","fecha": "10\/11\/2021"}]}');

Request request = new Request.Builder()
  .url("https://api-test.ticketbaiws.eus/tbai-completar/")
  .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": {
		"huella_tbai" : "TBAI-B01000012-131121-zG3wtCW3WlOSN-108",
		"qr" : "iVBORw0KGgoAAAANSUhEUgAAAfQAAAH0CAIAAABEtEjdAAAABmJ...",
		"url" : "https://batuz.eus/QRTBAI/?id=TBAI-..."
	}, 
	"msg": null 
}

Métodos TicketBAI

Métodos específicos para BATUZ BIZKAIA