Documento de representación - Descargar modelo
GET https://{entorno}.ticketbaiws.eus/doc-representante/modelo/
Descarga el documento de representación que autoriza a Ticketbai WS a enviar las facturas de la empresa en producción. El modelo depende del territorio de la empresa:
- Verifactu: documento de representación ante la AEAT.
- Bizkaia: modelo 140 (persona física) o 240 (persona jurídica) de Batuz.
- Gipuzkoa: autorización de representación de TicketBAI.
Devuelve el fichero PDF en base 64, con los datos de la empresa y del representante ya rellenos.
Los métodos GET permiten el envío de los parámetros en el body como payload JSON o mediante query string en la URL como se ve en el ejemplo cURL.
Empresas de Araba: este método no está disponible, porque en Araba la autorización es el registro del certificado de dispositivo (ver instrucciones). Devuelve un error:
{"result": "ERROR", "return": null, "msg": "El documento de representación no está disponible para empresas de Araba. Registra el certificado de dispositivo de Ticketbai WS en la sede de la Diputación Foral de Álava."}PARÁMETROS
| nombre_representante string obligatorio únicamente para personas jurídicas (Verifactu, Bizkaia y Gipuzkoa) Nombre y apellidos de la persona representante de la empresa que va a firmar el documento digitalmente. | Juan Martínez Pérez |
| nif_representante string obligatorio únicamente para personas jurídicas (Verifactu, Bizkaia y Gipuzkoa) NIF de la persona representante de la empresa que va a firmar el documento digitalmente. Este dato debe coincidir con el NIF de la firma digital. | 12345678Z |
| poblacion_representante string obligatorio únicamente para personas jurídicas en Verifactu Población de la persona representante de la empresa que va a firmar el documento digitalmente. | Madrid |
| direccion_representante string obligatorio únicamente para personas jurídicas en Verifactu Dirección de la persona representante de la empresa que va a firmar el documento digitalmente. | Calle Falsa 123 |
Las personas físicas no tienen que enviar ningún parámetro: el documento se rellena con los datos de la empresa. En Bizkaia y Gipuzkoa no se usan poblacion_representante ni direccion_representante; si se envían, se ignoran.
$ curl --request GET \
--url https://api-test.ticketbaiws.eus/doc-representante/modelo/ \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Token: xxx' \
--header 'Nif: 00000014Z'
--data '{"nombre_representante" : "Persona Representante","nif_representante" : "12345678Z","poblacion_representante" : "Madrid","direccion_representante" : "Calle Falsa 123"}'
$ composer require guzzlehttp/guzzle
<?php
require_once('vendor/autoload.php');
$client = new \GuzzleHttp\Client();
$response = $client->request('GET', 'https://api-test.ticketbaiws.eus/doc-representante/modelo/', [
'body' => '{"nombre_representante" : "Persona Representante","nif_representante" : "12345678Z","poblacion_representante" : "Madrid","direccion_representante" : "Calle Falsa 123"}',
'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/doc-representante/modelo/?nombre_representante=Persona Representante&nif_representante=12345678Z&poblacion_representante=Madrid&direccion_representante=Calle Falsa 123"
headers = {"Accept": "application/json", "Token" : "xxx", "Nif" : "00000014Z"}
response = requests.request("GET", url, headers=headers)
print(response.text)
CURL *hnd = curl_easy_init();
curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api-test.ticketbaiws.eus/doc-representante/modelo/?nombre_representante=Persona Representante&nif_representante=12345678Z&poblacion_representante=Madrid&direccion_representante=Calle Falsa 123");
struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Accept: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
CURLcode ret = curl_easy_perform(hnd);
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://api-test.ticketbaiws.eus/doc-representante/modelo/?nombre_representante=Persona Representante&nif_representante=12345678Z&poblacion_representante=Madrid&direccion_representante=Calle Falsa 123")
.get()
.addHeader("Accept", "application/json")
.addHeader("Token", "xxx")
.addHeader("Nif", "00000014Z")
.build();
Response response = client.newCall(request).execute();
HTTP/1.1 200 OK
{
"result": "OK",
"return": "JVBERi0xLjcNJeLjz9MNCjE1OSAwIG9iag08PC9MaW5lYXJpemVkIDEvTCAxMzQ0MTMwL08gMTYx...",
"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
Documento representación
- GET Documento Representación - Descargar modelo
- POST Documento Representación - Enviar documento
- GET Documento Representación - Descargar documento cargado
- DELETE Documento Representación - 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)
Factura electrónica B2B - SPFE (Ley Crea y Crece)
- POST SPFE - Comunicar pago, cobro, rechazo o impago
- GET SPFE - Consulta de pagos, cobros, rechazos e impagos
- GET SPFE - Facturas recibidas
