API >
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)
| |||||||
| 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 / Verifactu
- POST Nueva factura / subsanación (zuzendu) TicketBAI / Verifactu
- POST Completar factura simplificada
- GET Consulta factura TicketBAI / Verifactu
- GET Listado facturas TicketBAI / Verifactu
- GET Descarga XML TicketBAI / Verifactu
- GET Descarga factura en formato FacturaE
- GET Descarga factura en PDF
- GET Estado sistema
- DEL Anular factura TicketBAI / Verifactu
- PUT Forzar reenvío TicketBAI / Verifactu
- POST Validar NIF en la AEAT
- POST Validar NIF en el VIES
Métodos específicos para Verifactu
- GET Documento Representación Verifactu - Descargar modelo
- POST Documento Representación Verifactu - Enviar documento
- GET Documento Representación Verifactu - Descargar documento cargado
- DELETE Documento Representación Verifactu - Revocar documento cargado
Métodos específicos para BATUZ BIZKAIA
- GET Listado de epígrafes
- POST LROE - Facturas recibidas - Envío (BATUZ)
- PUT LROE - Facturas recibidas - Modificar (BATUZ)
- GET LROE - Facturas recibidas - Consulta (BATUZ)
- DEL LROE - Facturas recibidas - Anular (BATUZ)
- POST LROE - Criterio Caja COBROS - Envío (BATUZ)
- PUT LROE - Criterio Caja COBROS - Modificar (BATUZ)
- GET LROE - Criterio Caja COBROS - Consulta (BATUZ)
- DEL LROE - Criterio Caja COBROS - Anular (BATUZ)
- POST LROE - Criterio Caja PAGOS - Envío (BATUZ)
- PUT LROE - Criterio Caja PAGOS - Modificar (BATUZ)
- GET LROE - Criterio Caja PAGOS - Consulta (BATUZ)
- DEL LROE - Criterio Caja PAGOS - Anular (BATUZ)
