API > Documento de representación - Descargar modelo

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.


GET https://{entorno}.ticketbaiws.eus/doc-representante/modelo/
$ 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();
{ } Response JSON
HTTP/1.1 200 OK
{ 
	"result": "OK", 
	"return": "JVBERi0xLjcNJeLjz9MNCjE1OSAwIG9iag08PC9MaW5lYXJpemVkIDEvTCAxMzQ0MTMwL08gMTYx...", 
	"msg": null 
}

Métodos TicketBAI / Verifactu

Documento representación

Métodos específicos para BATUZ BIZKAIA

Factura electrónica B2B - SPFE (Ley Crea y Crece)

Otros métodos