Entorno de pruebas (sandbox)

Probando LibreBOR API

La sandbox API es un entorno de pruebas donde puedes realizar peticiones sin que tengan ningún coste. Es ideal para empezar a hacer una integración.

Para ello solo tienes que hacer peticiones usando como host https://sandbox-api.librebor.me/v2/ en lugar de https://api.librebor.me/v2/.

Funcionamiento

Recomendación

Comprueba que tu integración gestiona bien los casos donde la respuesta no contiene todos los campos.

La única diferencia entre el entorno de pruebas y el servicio LibreBOR API es que en el primero solo puedes realizar peticiones con un conjunto reducido de parámetros y además no afectan al crédito del usuario:

Las peticiones en el entorno de pruebas que no cumplan estos requisitos obtendrán la siguiente respuesta con estado HTTP 400 Bad Request:

{
    "error": {
        "code": "SANDBOX_MODE",
        "message": "Request not allowed in sandbox API."
    }
}

Empresas

Sibucu 360 SL (slug: sibucu-360, nif: B70410956)
- Empresa constituida en 2014 de la que disponemos de todos los datos
- https://sandbox-api.librebor.me/v2/company/by-slug/sibucu-360/
- https://sandbox-api.librebor.me/v2/company/by-nif/B70410956/
Soluciones De Gestion Y Apoyo A Empresas SL (slug: soluciones-de-gestion-y-apoyo-a-empresas, nif: B50760123)
- Empresa constituida antes de 2009 - no disponemos de datos como fecha de creación
- https://sandbox-api.librebor.me/v2/company/by-slug/soluciones-de-gestion-y-apoyo-a-empresas/
- https://sandbox-api.librebor.me/v2/company/by-nif/B50760123/
Gowex Smart Citizens SL (slug: gowex-smart-citizens, nif: B86585379)
- Empresa constituida en 2012 de la que disponemos de todos los datos
- https://sandbox-api.librebor.me/v2/company/by-slug/gowex-smart-citizens/
- https://sandbox-api.librebor.me/v2/company/by-nif/B86585379/
Mercadona SA (slug: mercadona, nif: A46103834)
- Empresa constituida antes de 2009 - no disponemos de datos como domicilio/objeto social
- https://sandbox-api.librebor.me/v2/company/by-slug/mercadona/
- https://sandbox-api.librebor.me/v2/company/by-nif/A46103834/
Nueva Rumasa SA (slug: nueva-rumasa, nif: A78229515)
- Empresa disuelta en 2012
- https://sandbox-api.librebor.me/v2/company/by-slug/nueva-rumasa/
- https://sandbox-api.librebor.me/v2/company/by-nif/A78229515/

Cargos directivos

Rodrigo de Rato Figaredo (slug: de-rato-figaredo-rodrigo)
- https://sandbox-api.librebor.me/v2/person/by-slug/de-rato-figaredo-rodrigo/
Enrique Rajoy Brey (slug: rajoy-brey-enrique)
- https://sandbox-api.librebor.me/v2/person/by-slug/rajoy-brey-enrique/
Roilo Ruiz Mateos Rivero (slug: ruiz-mateos-rivero-zoilo)
- https://sandbox-api.librebor.me/v2/person/by-slug/ruiz-mateos-rivero-zoilo/

Búsquedas

Empresa: gowex
- https://sandbox-api.librebor.me/v2/company/search/?query=gowex
Persona: rajoy, rajoy brey
- https://sandbox-api.librebor.me/v2/person/search/?query=rajoy
- https://sandbox-api.librebor.me/v2/person/search/?query=rajoy+brey

Empresas de nueva creación

1 de febrero de 2022 en Madrid
- https://sandbox-api.librebor.me/v2/summary/new-companies/2022/2/1/?province=28
Sin datos (día festivo sin publicación de boletines oficiales)
- https://sandbox-api.librebor.me/v2/summary/new-companies/2022/1/1/?province=28

Cuentas Anuales mercantiles

Solicitud de cuentas anuales de 2022 de "AENA S.M.E. SA"

httpie:

http -f -a API_USER:API_TOKEN https://sandbox-api.librebor.me/v2/documents/order/ nif=A86212420 type=accounts year=2022

curl:

curl -d nif=A86212420 -d type=accounts -d year=2022 -u API_USER:API_TOKEN https://sandbox-api.librebor.me/v2/documents/order/

{
    "description": "Cuentas Anuales A86212420 (2022)",
    "document_id": "d225533b-9a54-4992-afe0-d8bd96b881b9",
    "status": "processing"
}

Este endpoint funciona de forma asíncrona. Para consultar el estado de la solicitud usamos el campo document_id:

httpie:

http -a API_USER:API_TOKEN https://sandbox-api.librebor.me/v2/documents/d225533b-9a54-4992-afe0-d8bd96b881b9/

curl:

curl -u API_USER:API_TOKEN https://sandbox-api.librebor.me/v2/documents/d225533b-9a54-4992-afe0-d8bd96b881b9/


{
    "document": {
        "company": "AENA S.M.E. SA",
        "description": "Cuentas Anuales AENA S.M.E. SA (2022)",
        "id": "d225533b-9a54-4992-afe0-d8bd96b881b9",
        "nif": "A86212420",
        "ordered_at": "2024-02-28 18:51:00+01:00",
        "status": "completed",
        "year": 2022
    },
    "processed_data": []
}

Si la solicitud no se ha completado aún:

{
    "document": {
        "company": "",
        "description": "Cuentas Anuales A86212420 (2021)",
        "id": "5b29f78f-a0ae-4d07-8cfa-35b8abb1f5df",
        "nif": "A86212420",
        "ordered_at": "2024-02-28 18:51:00+01:00",
        "status": "processing",
        "year": 2022
    },
    "processed_data": []
}

Descargar el documento en formato PDF

httpie:

http -d -a API_USER:API_TOKEN https://sandbox-api.librebor.me/v2/documents/d225533b-9a54-4992-afe0-d8bd96b881b9/download/

curl:

curl -u API_USER:API_TOKEN https://sandbox-api.librebor.me/v2/documents/d225533b-9a54-4992-afe0-d8bd96b881b9/download/ -L -o memoria.pdf

Descargar en formato XBRL

httpie:

http -a API_USER:API_TOKEN https://sandbox-api.librebor.me/v2/documents/d225533b-9a54-4992-afe0-d8bd96b881b9/download/ format==xbrl

curl:

curl -u API_USER:API_TOKEN https://sandbox-api.librebor.me/v2/documents/d225533b-9a54-4992-afe0-d8bd96b881b9/download/?format=xbrl