Peticiones

(blue star) Índice

Ir arriba

Introducción

En este documento se van a detallar cada una de las peticiones que, actualmente, se pueden realizar en la API para cada bloque de Apiges Pro (Expedientes, Contactos…). Para el correcto funcionamiento y la obtención de los resultados esperados, se va a especificar en cada petición qué parámetros son obligatorios, los tipos de respuesta y ejemplos de las peticiones para entender mejor el funcionamiento.

Para ello, vamos a hablar primero de los parámetros/headers que comparten todas las peticiones que podemos realizar en la API:

Ir arriba

Estándar Request URL

http://<dominio>:<puerto>

Parámetro

Descripción

 Obligatorio Ejemplo
<dominio>

Dominio API

Sí

192.168.293.365
<puerto>

Puerto API

Sí

8080
Ir arriba

Estándar cURL

curl --location --request GET 'http://<dominio>:<puerto>/estados' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'

Header

Descripción

 Obligatorio Ejemplo
<idioma>

Idioma para las descripciones

No

es
<token>

Token de acceso

Sí

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OH

 

Importante: El tipo de autenticación que se utiliza en la API es JWT, y su nomenclatura es: Bearer <token>

 

Opciones para el parámetro <idioma>:

  • Español: es (valor por defecto)
  • Francés: fr
  • Portugués: pt
  • Catalán: ca
  • Alemán: de
  • Inglés: en
  • Italiano: it
Ir arriba

Ejemplo cURL con Headers

curl --location --request GET 'http://<dominio>:<puerto>/estados' \
--header 'accept-language: de' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'
Ir arriba

Estándar Response

Para garantizar la seguridad de la API, se realiza una comprobación a nivel global sobre cada petición para evaluar el token de acceso. Esta validación del token puede provocar dos tipos de respuesta en las peticiones (además de las particulares de cada una de ellas):

401 Usuario no autorizado

403 El usuario no tiene permisos para este ámbito

 

En caso de obtener alguna de estas dos respuestas, intenta autenticarte de nuevo y, si el error persiste, ponte por favor en contacto con Grupo10 a través del apartado Soporte

Ir arriba

Autenticación

Ir arriba

[GET] /login

Ir arriba

Descripción

Método de autenticación a la API. Devuelve un token de acceso a utilizar en el resto de peticiones de la API.

Ir arriba

Petición

GET /login

Ir arriba

Request URL

http://<dominio>:<puerto>/login?username=<username>&password=<password>
Ir arriba

cURL

curl --location --request GET 'http://<dominio>:<puerto>/login?username=<username>&password=<password>'

Parámetro

Descripción

 Obligatorio Ejemplo
<username>

Nombre usuario

Sí

maria1294
<password>

Contraseña usuario

Sí

admin
Ir arriba

Ejemplo de request URL

http://192.168.293.365:8071/login?username=maria1294&password=admin
Ir arriba

Ejemplo de cURL

curl --location --request GET 'http://192.168.293.365:8071/login?username=maria1294&password=admin'

Para el método de login no hace falta incluir headers

Ir arriba

Responses

200 Ha ido correctamente

{
  "statusCode": 200,
  "message": "Petición finalizada correctamente",
  "data": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH"
}

401 Usuario no autorizado

{
  "statusCode": 401,
  "message": "Usuario no autorizado",
  "data": null
}

500 Ha ocurrido un error

{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}
Ir arriba

[POST]/anotaciones/search

Ir arriba

Descripción

Búsqueda de anotaciones con filtros. Devuelve un listado con las anotaciones que cumplen los filtros de búsqueda.

Ir arriba

Petición

POST /anotaciones/search

Ir arriba

Petición con opciones de paginación

POST /anotaciones/search?PageSize=<size>&PageNumber=<number>

Ir arriba

Request URL

http://<dominio>:<puerto>/anotaciones/search'
Ir arriba

Request URL con opciones de paginación

http://<dominio>:<puerto>/anotaciones/search?PageSize=<size>&PageNumber=<number>'

Parámetro

Descripción

 Obligatorio Ejemplo
<size>

Número de elementos por página

No

10
<number>

Número de página

No

2
Ir arriba

cURL

curl --location --request POST 'http://<dominio>:<puerto>/anotaciones/search' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '<body>'
Ir arriba

cURL con opciones de paginación

curl --location --request POST 'http://<dominio>:<puerto>/anotaciones/search?PageSize=<size>&PageNumber=<number>' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '<body>'

Header

Descripción

 Obligatorio
<body>

Conjunto de filtros a aplicar sobre la búsqueda

No
Ir arriba

Body (request)

{
  "generales": [
    {
      "campo": <campo>,
      "valores": <valores>,
      "codigo": <filtro>
    }
  ]
}

Parámetro

Descripción

 Obligatorio Tipo parámetro
<campo>

Campo por el que se va a aplicar el filtro dentro del bloque al que corresponde. En este caso, sobre contactos, domicilios o titulares

Sí

Cadena de caracteres
<valores>

Lista de valores

Sí

Lista de valores
<filtro>

Tipo de filtro a aplicar. Consultar petición [GET] /filtros para más información

Sí

Cadena de caracteres

 

¡Importante!

Al ser una petición POST, tenemos que incluir un header adicional (Content-Type) para indicar el formato del body. Para esta petición es application/json

No olvidar el token

Ir arriba

Ejemplo de request URL

http://192.168.293.365:8071/anotaciones/search'
Ir arriba

Ejemplo de request URL con opciones de paginación

http://192.168.293.365:8071/anotaciones/search?PageSize=10&PageNumber=2'
Ir arriba

Ejemplo de body

{
  "generales": [
    {
      "campo": "tipo",
      "valores": [
        "EMAIL"
      ],
      "codigo": "EQ"
    },
    {
      "campo": "idExpediente",
      "valores": [
        "42"
      ],
      "codigo": "EQ"
    }
  ]
}

Campo

Descripción

 Obligatorio Tipo parámetro

“tipo”

Filtro sobre el tipo de contacto

No

Cadena de caracteres

“idExpediente”

Filtro sobre el id del expediente asociado a la anotacion

No

Numeros enteros
Ir arriba

Ejemplo de cURL

curl --location --request POST 'http://192.168.293.365:8071/anotaciones/search' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH' \
--header 'Content-Type: application/json' \
--data-raw '{
  "generales": [
    {
      "campo": "tipo",
      "valores": [
        "EMAIL"
      ],
      "codigo": "EQ"
    },
    {
      "campo": "idExpediente",
      "valores": [
        "424"
      ],
      "codigo": "EQ"
    }
  ]
}'
Ir arriba

Ejemplo de cURL con opciones de paginación

curl --location --request POST 'http://192.168.293.365:8071/anotaciones/search?PageSize=10&PageNumber=2' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH' \
--header 'Content-Type: application/json' \
--data-raw '{
  "generales": [
    {
      "campo": "tipo",
      "valores": [
        "EMAIL"
      ],
      "codigo": "EQ"
    },
    {
      "campo": "idExpediente",
      "valores": [
        "424"
      ],
      "codigo": "EQ"
    }
  ]
}'
Ir arriba

Responses validaciones de campos

400 Valor no válido para el campo ‘tipo’

{
    "statusCode": 400,
    "message": "Filtro 'X' no contemplado. [GET] /filtros para más información",
    "data": null
}

400 Valor no válido para el campo ‘idExpediente’

{
    "statusCode": 400,
    "message": "Campo 'X' no contemplado",
    "data": null
}

400 Lista de valores vacía

{
    "statusCode": 400,
    "message": "Se deben informar valores para el tipo de filtro 'EQ'",
    "data": null
}

400 Lista de ‘valores’ con valor vacío

{
    "statusCode": 400,
    "message": "El valor no puede ser nulo",
    "data": null
}

400 Filtro ‘Between’ con más de dos valores

{
    "statusCode": 400,
    "message": "El filtro 'BT' tiene que tener únicamente dos valores",
    "data": null
}
Ir arriba

Headers responses

En esta petición, además de devolver un listado con los contactos que cumplen los filtros de búsqueda, en la cabecera de la respuesta se devuelve el parámetro X-Pagination con la siguiente información:

{"TotalCount":<total>,"PageSize":<size>,"CurrentPage":<current_page>,"TotalPages":<total_pages>,"HasNextPage":<has_next_page>,"HasPreviousPage":<has_previous_page>,"NextPageUrl":<next_url>,"PreviousPageUrl":<previous_url>}

Parámetro

Descripción
<total>

Número total de contactos encontrados en la búsqueda
<size>

Número de elementos por página
<current_page>

Página actual
<total_pages>

Número total de páginas
<has_next_page>

Indica si hay página siguiente
<has_previous_page>

Indica si hay página anterior
<next_url>

URL de la siguiente página
<previous_url>

URL de la página anterior
Ir arriba

Ejemplo headers responses

{"TotalCount":2432,"PageSize":10,"CurrentPage":1,"TotalPages":244,
"HasNextPage":true,"HasPreviousPage":false,"NextPageUrl":"","PreviousPageUrl":""}
Ir arriba

Responses

200 Ha ido correctamente

{
  "statusCode": 200,
  "message": "Petición finalizada correctamente",
  "data": 
    {
      "id": 1,
      "codigo": "A10",
      "fechaAlta": "27/01/2014",
      "tipo": {
        "codigo": "Carta",
        "descripcion": "Carta al cliente"
      },
      "usuario": {
        "codigo": "BB",
        "nombre": "Beatriz",
        "apellidos": "Blanco"
      },
      "idExpediente":1234,
      "rutaFichero": "\\ruta\\docs\\",
      "texto":{
          "codigo": "C3",
          "descripcion": "INCUMPLIMIENTO DE PAGO"
        }     
    }
}

500 Ha ocurrido un error

{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}
Ir arriba

Articulos

Ir arriba

[GET] /articulos

Ir arriba

Descripción

Devuelve un listado con los articulos disponibles.

Ir arriba

Petición

GET /articulos

Ir arriba

Request URL

http://<dominio>:<puerto>/articulos
Ir arriba

cURL

curl --location --request GET 'http://<dominio>:<puerto>/articulos' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'

Importante: no olvidar headers

Ir arriba

Ejemplo de request URL

http://192.168.293.365:8071/articulos
Ir arriba

Ejemplo de cURL

curl --location --request GET 'http://192.168.293.365:8071/articulos' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'
Ir arriba

Responses

200 Ha ido correctamente

{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "codigo": "EQ",
            "descripcion": "Igual que el/los valor(es)",
            "estado": {
                  "codigo": "A", 
                  "descripcion": "Alta"
            },
            "tipo": {
                  "codigo": "E", 
                  "descripcion": "Factura Emitida"
            },
            "centroCoste": {
                  "codigo": "05", 
                  "descripcion": "GE - Tramitacion de Registro"
            }
        },
        { 
            "codigo": "4ANU", 
            "descripcion": "Cuarta Anulacion",
            "estado": {
                  "codigo": "A", 
                  "descripcion": "Alta"
            },
            "tipo": {
                  "codigo": "R", 
                  "descripcion": "Factura Recibida"
            },
            "centroCoste": {
                  "codigo": "05", 
                  "descripcion": "GE - Tramitacion de Registro"
            }
        }
    ]
}

500 Ha ocurrido un error

{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}
Ir arriba

Generales

Ir arriba

[GET] /acciones

Ir arriba

Descripción

Devuelve un listado con las acciones comerciales disponibles en las búsquedas.

Ir arriba

Petición

GET /acciones

Ir arriba

Request URL

http://<dominio>:<puerto>/acciones
Ir arriba

cURL

curl --location --request GET 'http://<dominio>:<puerto>/acciones' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'

Importante: no olvidar headers

Ir arriba

Ejemplo de request URL

http://192.168.293.365:8071/acciones
Ir arriba

Ejemplo de cURL

curl --location --request GET 'http://192.168.293.365:8071/acciones' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'
Ir arriba

Responses

200 Ha ido correctamente

{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "codigo": "01",
            "descripcion": "Firma Contrato"
        },
        { "codigo": "02",
          "descripcion": "Alta de cliente"
        }
    ]
}

500 Ha ocurrido un error

{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}
Ir arriba

[GET] /cargos

Ir arriba

Descripción

Devuelve un listado con los cargos disponibles en las búsquedas.

Ir arriba

Petición

GET /cargos

Ir arriba

Request URL

http://<dominio>:<puerto>/cargos
Ir arriba

cURL

curl --location --request GET 'http://<dominio>:<puerto>/cargos' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'

Importante: no olvidar headers

Ir arriba

Ejemplo de request URL

http://192.168.293.365:8071/cargos
Ir arriba

Ejemplo de cURL

curl --location --request GET 'http://192.168.293.365:8071/cargos' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'
Ir arriba

Responses

200 Ha ido correctamente

{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "codigo": "1",
            "descripcion": "Ejecutivo"
        }
    ]
}

500 Ha ocurrido un error

{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}
Ir arriba

[GET] /codigos/postales

Ir arriba

Descripción

Devuelve un listado con los códigos postales disponibles en las búsquedas.

Ir arriba

Petición

GET /codigos/postales

Ir arriba

Request URL

http://<dominio>:<puerto>/codigos/postales
Ir arriba

cURL

curl --location --request GET 'http://<dominio>:<puerto>/codigos/postales' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'

Importante: no olvidar headers

Ir arriba

Ejemplo de request URL

http://192.168.293.365:8071/codigos/postales
Ir arriba

Ejemplo de cURL

curl --location --request GET 'http://192.168.293.365:8071/codigos/postales' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'
Ir arriba

Responses

200 Ha ido correctamente

{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "codigo": "01000",
            "descripcion": "VITORIA-GASTEIZ (VER CALLEJERO)"
        }
    ]
}

500 Ha ocurrido un error

{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}
Ir arriba

[GET] /companias

Ir arriba

Descripción

Devuelve un listado con las compañias disponibles.

Ir arriba

Petición

GET /companias

Ir arriba

Request URL

http://<dominio>:<puerto>/companias
Ir arriba

cURL

curl --location --request GET 'http://<dominio>:<puerto>/companias' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'

Importante: no olvidar headers

Ir arriba

Ejemplo de request URL

http://192.168.293.365:8071/companias
Ir arriba

Ejemplo de cURL

curl --location --request GET 'http://192.168.293.365:8071/companias' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'
Ir arriba

Responses

200 Ha ido correctamente

{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "codigo": "1",
            "descripcion": "Companias"
        }
    ]
}

500 Ha ocurrido un error

{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}
Ir arriba

[GET] /departamentos

Ir arriba

Descripción

Devuelve un listado con los departamentos disponibles en las búsquedas.

Ir arriba

Petición

GET /departamentos

Ir arriba

Request URL

http://<dominio>:<puerto>/departamentos
Ir arriba

cURL

curl --location --request GET 'http://<dominio>:<puerto>/departamentos' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'

Importante: no olvidar headers

Ir arriba

Ejemplo de request URL

http://192.168.293.365:8071/departamentos
Ir arriba

Ejemplo de cURL

curl --location --request GET 'http://192.168.293.365:8071/departamentos' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'
Ir arriba

Responses

200 Ha ido correctamente

{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "codigo": "01",
            "descripcion": "Marca"
        }
    ]
}

500 Ha ocurrido un error

{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}
Ir arriba

[GET] /filtros

Ir arriba

Descripción

Devuelve un listado con los filtros disponibles en las búsquedas.

Ir arriba

Petición

GET /filtros

Ir arriba

Request URL

http://<dominio>:<puerto>/filtros
Ir arriba

cURL

curl --location --request GET 'http://<dominio>:<puerto>/filtros' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'

Importante: no olvidar headers

Ir arriba

Ejemplo de request URL

http://192.168.293.365:8071/filtros
Ir arriba

Ejemplo de cURL

curl --location --request GET 'http://192.168.293.365:8071/filtros' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'
Ir arriba

Responses

200 Ha ido correctamente

{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "codigo": "EQ",
            "descripcion": "Igual que el/los valor(es)"
        },
        {
            "codigo": "BT",
            "descripcion": "Between - Resultados entre dos valores"
        }
    ]
}

500 Ha ocurrido un error

{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}
Ir arriba

[GET] /formas/fiscales

Ir arriba

Descripción

Devuelve un listado con las formas fiscales disponibles en las búsquedas.

Ir arriba

Petición

GET /formas/fiscales

Ir arriba

Request URL

http://<dominio>:<puerto>/formas/fiscales
Ir arriba

cURL

curl --location --request GET 'http://<dominio>:<puerto>/formas/fiscales' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'

Importante: no olvidar headers

Ir arriba

Ejemplo de request URL

http://192.168.293.365:8071/formas/fiscales
Ir arriba

Ejemplo de cURL

curl --location --request GET 'http://192.168.293.365:8071/formas/fiscales' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'
Ir arriba

Responses

200 Ha ido correctamente

{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "codigo": "E",
            "descripcion": "Entidad"
        }
    ]
}

500 Ha ocurrido un error

{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}
Ir arriba

[GET] /formas/juridicas

Ir arriba

Descripción

Devuelve un listado con las formas jurídicas disponibles en las búsquedas.

Ir arriba

Petición

GET /formas/juridicas

Ir arriba

Request URL

http://<dominio>:<puerto>/formas/juridicas
Ir arriba

cURL

curl --location --request GET 'http://<dominio>:<puerto>/formas/juridicas' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'

Importante: no olvidar headers

Ir arriba

Ejemplo de request URL

http://192.168.293.365:8071/formas/juridicas
Ir arriba

Ejemplo de cURL

curl --location --request GET 'http://192.168.293.365:8071/formas/juridicas' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'
Ir arriba

Responses

200 Ha ido correctamente

{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "codigo": "AB",
            "descripcion": "AB"
        }
    ]
}

500 Ha ocurrido un error

{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}
Ir arriba

[GET] /formas/pago

Ir arriba

Descripción

Devuelve un listado con las formas de pago disponibles en las búsquedas.

Ir arriba

Petición

GET /formas/pago

Ir arriba

Request URL

http://<dominio>:<puerto>/formas/pago
Ir arriba

cURL

curl --location --request GET 'http://<dominio>:<puerto>/formas/pago' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'

Importante: no olvidar headers

Ir arriba

Ejemplo de request URL

http://192.168.293.365:8071/formas/pago
Ir arriba

Ejemplo de cURL

curl --location --request GET 'http://192.168.293.365:8071/formas/pago' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'
Ir arriba

Responses

200 Ha ido correctamente

{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "codigo": "A",
            "descripcion": "Efectivo a la vista"
        }
    ]
}

500 Ha ocurrido un error

{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}
Ir arriba

[GET] /empresas

Ir arriba

Descripción

Devuelve un listado con las empresas disponibles.

Ir arriba

Petición

GET /empresas

Ir arriba

Request URL

http://<dominio>:<puerto>/empresas'
Ir arriba

cURL

curl --location --request GET 'http://<dominio>:<puerto>/empresas' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'

Importante: no olvidar headers

Ir arriba

Ejemplo de request URL

http://192.168.293.365:8071/empresas'
Ir arriba

Ejemplo de cURL

curl --location --request GET 'http://192.168.293.365:8071/empresas' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'
Ir arriba

Responses

200 Ha ido correctamente

{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        { 
            "codigo": "E1",
            "descripcion": "Empresa 1",
            "pais": {
                  "codigo": "ES",
                  "descripcion": "España"
            },
            "moneda": {
                  "codigo": "EUR",
                  "descripcion": "Moneda de los estados miembros de EMU"
            },
            "CIF": "R2788776B"
        },
        {
            "codigo": "E2",
            "descripcion": "Empresa 2",
            "pais": {
                  "codigo": "ES",
                  "descripcion": "España"
            },
            "moneda": {
                  "codigo": "EUR",
                  "descripcion": "Moneda de los estados miembros de EMU"
            },
            "CIF": "E0413308""
        },
        {
            "codigo": "E3",
            "descripcion": "Empresa 3",
            "pais": {
                  "codigo": "ES",
                  "descripcion": "España"
            },
            "moneda": {
                  "codigo": "EUR",
                  "descripcion": "Moneda de los estados miembros de EMU"
            },
            "CIF": "R2777776B"
        },
        {
            "codigo": "E4",
            "descripcion": "Empresa 4",
            "pais": {
                  "codigo": "ES",
                  "descripcion": "España"
            },
            "moneda": {
                  "codigo": "EUR",
                  "descripcion": "Moneda de los estados miembros de EMU"
            },
            "CIF": "V04182408"
        }
    ]
}

500 Ha ocurrido un error

{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}
Ir arriba

[GET] /estados

Ir arriba

Descripción

Devuelve un listado con los estados disponibles.

Ir arriba

Petición

GET /estados

Ir arriba

Request URL

http://<dominio>:<puerto>/estados
Ir arriba

cURL

curl --location --request GET 'http://<dominio>:<puerto>/estados' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'

Importante: no olvidar headers

Ir arriba

Ejemplo de request URL

http://192.168.293.365:8071/estados
Ir arriba

Ejemplo de cURL

curl --location --request GET 'http://192.168.293.365:8071/estados' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'
Ir arriba

Responses

200 Ha ido correctamente

{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "codigo": "A",
            "descripcion": "Alta"
        },
        {
            "codigo": "B",
            "descripcion": "Baja"
        }
    ]
}

500 Ha ocurrido un error

{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}
Ir arriba

[GET] /estados/facturas

Ir arriba

Descripción

Devuelve un listado con los estados de facturas disponibles.

Ir arriba

Petición

GET /estados/facturas

Ir arriba

Request URL

http://<dominio>:<puerto>/estados/facturas
Ir arriba

cURL

curl --location --request GET 'http://<dominio>:<puerto>/estados/facturas' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'

Importante: no olvidar headers

Ir arriba

Ejemplo de request URL

http://192.168.293.365:8071/estados/facturas
Ir arriba

Ejemplo de cURL

curl --location --request GET 'http://192.168.293.365:8071/estados/facturas' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'
Ir arriba

Responses

200 Ha ido correctamente

{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "tipo": {
                        "codigo": "E",
                        "descripcion": "Factura Emitida"
            },
            "codigo": "0",
            "descripcion": "Factura Rechazada por el Corresponsal"
        },
        {
            "tipo": {
                        "codigo": "R",
                        "descripcion": "Factura Recibida"
            },
            "codigo": "8",
            "descripcion": "Clientes Morosos"
        }
    ]
}

500 Ha ocurrido un error

{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}
Ir arriba

[GET] /estados/tareas

Ir arriba

Descripción

Devuelve un listado con los estados de tareas.

Ir arriba

Petición

GET /estados/tareas

Ir arriba

Request URL

http://<dominio>:<puerto>/estados/tareas
Ir arriba

cURL

curl --location --request GET 'http://<dominio>:<puerto>/estados/tareas' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'

Importante: no olvidar headers

Ir arriba

Ejemplo de request URL

http://192.168.293.365:8071/estados/tareas
Ir arriba

Ejemplo de cURL

curl --location --request GET 'http://192.168.293.365:8071/estados/tareas' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'
Ir arriba

Responses

200 Ha ido correctamente

{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "codigo": "A",
            "descripcion": "Aplazado"
        }
    ]
}

500 Ha ocurrido un error

{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}
Ir arriba

[GET] /idiomas/descripciones

Ir arriba

Descripción

Devuelve un listado con los idiomas disponibles.

Ir arriba

Petición

GET /idiomas/descripciones

Ir arriba

Request URL

http://<dominio>:<puerto>/idiomas/descripciones'
Ir arriba

cURL

curl --location --request GET 'http://<dominio>:<puerto>/idiomas/descripciones' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'

Importante: no olvidar headers

Ir arriba

Ejemplo de request URL

http://192.168.293.365:8071/idiomas/descripciones'
Ir arriba

Ejemplo de cURL

curl --location --request GET 'http://192.168.293.365:8071/idiomas/descripciones' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'
Ir arriba

Responses

200 Ha ido correctamente

{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "codigo": "bg",
            "descripcion": "Búlgaro"
        },
        {
            "codigo": "en",
            "descripcion": "Inglés"
        },
        {
            "codigo": "es",
            "descripcion": "Español"
        },
        {
            "codigo": "et",
            "descripcion": "Estonio"
        }
    ]
}

500 Ha ocurrido un error

{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}
Ir arriba

[GET] /modalidades

Ir arriba

Descripción

Devuelve un listado con las modalidades disponibles.

Ir arriba

Petición

GET /modalidades

Ir arriba

Request URL

http://<dominio>:<puerto>/modalidades'
Ir arriba

cURL

curl --location --request GET 'http://<dominio>:<puerto>/modalidades' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'

Importante: no olvidar headers

Ir arriba

Ejemplo de request URL

http://192.168.293.365:8071/modalidades'
Ir arriba

Ejemplo de cURL

curl --location --request GET 'http://192.168.293.365:8071/modalidades' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'
Ir arriba

Responses

200 Ha ido correctamente

{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "codigo": "A",
            "descripcion": "Marca de la Unión Europea"
        },
        {
            "codigo": "H",
            "descripcion": "Marca Internacional"
        },
        {
            "codigo": "P",
            "descripcion": "Patente"
        },
        {
            "codigo": "U",
            "descripcion": "Modelo de Utilidad"
        }
    ]
}

500 Ha ocurrido un error

{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}
Ir arriba

[GET] /monedas

Ir arriba

Descripción

Devuelve un listado con las monedas disponibles.

Ir arriba

Petición

GET /monedas

Ir arriba

Request URL

http://<dominio>:<puerto>/monedas'
Ir arriba

cURL

curl --location --request GET 'http://<dominio>:<puerto>/monedas' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'

Importante: no olvidar headers

Ir arriba

Ejemplo de request URL

http://192.168.293.365:8071/monedas'
Ir arriba

Ejemplo de cURL

curl --location --request GET 'http://192.168.293.365:8071/monedas' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'
Ir arriba

Responses

200 Ha ido correctamente

{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "codigo": "EUR",
            "descripcion": "Moneda de los estados miembros de EMU"
        },
        {
            "codigo": "GBP",
            "descripcion": "Libra Británica"
        },
        {
            "codigo": "USD",
            "descripcion": "Dólar Americano"
        }
    ]
}

500 Ha ocurrido un error

{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}
Ir arriba

[GET] /nacionalidades

Ir arriba

Descripción

Devuelve un listado con las nacionalidades disponibles.

Ir arriba

Petición

GET /nacionalidades

Ir arriba

Request URL

http://<dominio>:<puerto>/nacionalidades'
Ir arriba

cURL

curl --location --request GET 'http://<dominio>:<puerto>/nacionalidades' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'

Importante: no olvidar headers

Ir arriba

Ejemplo de request URL

http://192.168.293.365:8071/nacionalidades'
Ir arriba

Ejemplo de cURL

curl --location --request GET 'http://192.168.293.365:8071/nacionalidades' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'
Ir arriba

Responses

200 Ha ido correctamente

{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "codigo": "AD",
            "descripcion": "Andorra"
        },
        {
            "codigo": "AE",
            "descripcion": "Emiratos Árabes Unidos"
        }
    ]
}

500 Ha ocurrido un error

{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}
Ir arriba

[GET] /paises

Ir arriba

Descripción

Devuelve un listado con los países disponibles.

Ir arriba

Petición

GET /paises

Ir arriba

Request URL

http://<dominio>:<puerto>/paises'
Ir arriba

cURL

curl --location --request GET 'http://<dominio>:<puerto>/paises' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'

Importante: no olvidar headers

Ir arriba

Ejemplo de request URL

http://192.168.293.365:8071/paises'
Ir arriba

Ejemplo de cURL

curl --location --request GET 'http://192.168.293.365:8071/paises' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'
Ir arriba

Responses

200 Ha ido correctamente

{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "codigo": "AL",
            "descripcion": "Albania"
        },
        {
            "codigo": "AM",
            "descripcion": "Armenia"
        },
        {
            "codigo": "AR",
            "descripcion": "Argentina"
        },
        {
            "codigo": "AS",
            "descripcion": "Samoa Americana (American Samoa)"
        },
        {
            "codigo": "AT",
            "descripcion": "Austria"
        }
    ]
}

500 Ha ocurrido un error

{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}
Ir arriba

[GET] /secciones

Ir arriba

Descripción

Devuelve un listado con las secciones disponibles.

Ir arriba

Petición

GET /secciones

Ir arriba

Request URL

http://<dominio>:<puerto>/secciones'
Ir arriba

cURL

curl --location --request GET 'http://<dominio>:<puerto>/secciones' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'

Importante: no olvidar headers

Ir arriba

Ejemplo de request URL

http://192.168.293.365:8071/secciones'
Ir arriba

Ejemplo de cURL

curl --location --request GET 'http://192.168.293.365:8071/secciones' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'
Ir arriba

Responses

200 Ha ido correctamente

{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "codigo": "00",
            "descripcion": "Otros"
        },
        {
            "codigo": "01",
            "descripcion": "Tickets"
        }
    ]
}

500 Ha ocurrido un error

{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}
Ir arriba

[GET] /tarifas

Ir arriba

Descripción

Devuelve un listado con las tarifas disponibles.

Ir arriba

Petición

GET /tarifas

Ir arriba

Request URL

http://<dominio>:<puerto>/tarifas'
Ir arriba

cURL

curl --location --request GET 'http://<dominio>:<puerto>/tarifas' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'

Importante: no olvidar headers

Ir arriba

Ejemplo de request URL

http://192.168.293.365:8071/tarifas'
Ir arriba

Ejemplo de cURL

curl --location --request GET 'http://192.168.293.365:8071/tarifas' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'
Ir arriba

Responses

200 Ha ido correctamente

{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "codigo": "1",
            "descripcion": "Tarifa",
        }
    ]
}

500 Ha ocurrido un error

{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}
Ir arriba

[GET] /tasas

Ir arriba

Descripción

Devuelve un listado con las tasas disponibles.

Ir arriba

Petición

GET /tasas

Ir arriba

Request URL

http://<dominio>:<puerto>/tasas'
Ir arriba

cURL

curl --location --request GET 'http://<dominio>:<puerto>/tasas' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'

Importante: no olvidar headers

Ir arriba

Ejemplo de request URL

http://192.168.293.365:8071/tasas'
Ir arriba

Ejemplo de cURL

curl --location --request GET 'http://192.168.293.365:8071/tasas' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'
Ir arriba

Responses

200 Ha ido correctamente

{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "codigo": "DINAPI070",
            "descripcion": "Marcas - Publicacion",
            "moneda":
              {
                "codigo":"EUR",
                "descripcion":"Euro"
              },
            "oficina":
              {
                "codigo":"EUR",
                "descripcion":"Euro"
              },
            "importe":95.00
        }
    ]
}

500 Ha ocurrido un error

{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}










Ir arriba
[GET] /tipos/anotaciones


Ir arriba
Descripción


Devuelve un listado con los tipos disponibles para anotaciones.






Ir arriba
Petición






GET /tipos/anotaciones






Ir arriba
Request URL


http://<dominio>:<puerto>/tipos/anotaciones'


Ir arriba
cURL


curl --location --request GET 'http://localhost:7143/tipos/anotaciones' \ 
--header 'accept: application/json' \ 
--header 'Authorization: Bearer <token>'






Importante: no olvidar headers






Ir arriba
Ejemplo de request URL


http://192.168.293.365:8071/tipos/anotaciones'


Ir arriba
Ejemplo de cURL


curl --location --request GET 'http://192.168.293.365:8071/tipos/anotaciones' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'


Ir arriba
Responses


200 Ha ido correctamente


{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "codigo": "CARTA",
            "descripcion": "Carta al cliente"
        },
        {
            "codigo": "1AVISO",
            "descripcion": "Primer aviso renovacion"
        }
    ]
}


500 Ha ocurrido un error


{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}











Ir arriba
[GET] /tipos/contactos


Ir arriba
Descripción


Devuelve un listado con los tipos disponibles para contactos.






Ir arriba
Petición






GET /tipos/contactos






Ir arriba
Request URL


http://<dominio>:<puerto>/tipos/contactos'


Ir arriba
cURL


curl --location --request GET 'http://<dominio>:<puerto>/tipos/contactos' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'






Importante: no olvidar headers






Ir arriba
Ejemplo de request URL


http://192.168.293.365:8071/tipos/contactos'


Ir arriba
Ejemplo de cURL


curl --location --request GET 'http://192.168.293.365:8071/tipos/contactos' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'


Ir arriba
Responses


200 Ha ido correctamente


{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "codigo": "A",
            "descripcion": "Agente"
        },
        {
            "codigo": "B",
            "descripcion": "Abogado"
        },
        {
            "codigo": "C",
            "descripcion": "Cliente"
        }
    ]
}


500 Ha ocurrido un error


{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}






Ir arriba
[GET] /tipos/descripciones


Ir arriba
Descripción


Devuelve un listado con los tipos disponibles para tipos de descripciones.






Ir arriba
Petición






GET /tipos/descripciones






Ir arriba
Request URL


http://<dominio>:<puerto>/tipos/descripciones'


Ir arriba
cURL


curl --location --request GET 'http://<dominio>:<puerto>/tipos/descripciones' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'






Importante: no olvidar headers






Ir arriba
Ejemplo de request URL


http://192.168.293.365:8071/tipos/descripciones'


Ir arriba
Ejemplo de cURL


curl --location --request GET 'http://192.168.293.365:8071/tipos/descripciones' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'










Ir arriba
Responses


200 Ha ido correctamente


{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "codigo": "DT",
            "descripcion": "Denominación"
        },
        {
            "codigo": "DE",
            "descripcion": "Descripción"
        },
        {
            "codigo": "IN",
            "descripcion": "Indicación"
        },
        {
            "codigo": "RE",
            "descripcion": "Renuncia"
        }
    ]
}


500 Ha ocurrido un error


{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}










Ir arriba
[GET] /tipos/domicilios


Ir arriba
Descripción


Devuelve un listado con los tipos disponibles para tipos de domicilios.






Ir arriba
Petición






GET /tipos/domicilios






Ir arriba
Request URL


http://<dominio>:<puerto>/tipos/domicilios'


Ir arriba
cURL


curl --location --request GET 'http://<dominio>:<puerto>/tipos/domicilios' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'






Importante: no olvidar headers






Ir arriba
Ejemplo de request URL


http://192.168.293.365:8071/tipos/domicilios'


Ir arriba
Ejemplo de cURL


curl --location --request GET 'http://192.168.293.365:8071/tipos/domicilios' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'






Ir arriba
Responses


200 Ha ido correctamente


{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
         {
            "codigo": "A",
            "descripcion": "Etiqueta Alternativa"
        },
        {
            "codigo": "C",
            "descripcion": "Solo Correspondencia"
        },
        {
            "codigo": "F",
            "descripcion": "Solo Facturación"
        },
        {
            "codigo": "G",
            "descripcion": "Genérico"
        }
    ]
}


500 Ha ocurrido un error


{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}


Ir arriba
[GET] /tipos/estados/facturas


Ir arriba
Descripción


Devuelve un listado con los tipos disponibles para los gastos.






Ir arriba
Petición






GET /tipos/estados/facturas


Ir arriba
Request URL


http://<dominio>:<puerto>/tipos/estados/facturas'


Ir arriba
cURL


curl --location --request GET 'http://<dominio>:<puerto>/tipos/estados/facturas' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'






Importante: no olvidar headers






Ir arriba
Ejemplo de request URL


http://192.168.293.365:8071/tipos/estados/facturas'


Ir arriba
Ejemplo de cURL


curl --location --request GET 'http://192.168.293.365:8071/tipos/estados/facturas' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'


Ir arriba
Responses


200 Ha ido correctamente


{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
         {
            "codigo": "E",
            "descripcion": "Facturas Emitidas"
        },
        {
            "codigo": "P",
            "descripcion": "Pago de Tasa"
        },
        {
            "codigo": "R",
            "descripcion": "Facturas Recibidas"
        }
    ]
}


500 Ha ocurrido un error


{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}


Ir arriba
[GET] /tipos/gastos


Ir arriba
Descripción


Devuelve un listado con los tipos disponibles para los gastos.






Ir arriba
Petición






GET /tipos/gastos






Ir arriba
Request URL


http://<dominio>:<puerto>/tipos/gastos'


Ir arriba
cURL


curl --location --request GET 'http://<dominio>:<puerto>/tipos/gastos' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'






Importante: no olvidar headers






Ir arriba
Ejemplo de request URL


http://192.168.293.365:8071/tipos/gastos'


Ir arriba
Ejemplo de cURL


curl --location --request GET 'http://192.168.293.365:8071/tipos/gastos' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'


Ir arriba
Responses


200 Ha ido correctamente


{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
         {
            "codigo": "00",
            "descripcion": "Traspasos"
        }
    ]
}


500 Ha ocurrido un error


{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}


Ir arriba
[GET] /tipos/potenciales


Ir arriba
Descripción


Devuelve un listado con los tipos de potenciales.






Ir arriba
Petición






GET /tipos/potenciales






Ir arriba
Request URL


http://<dominio>:<puerto>/tipos/potenciales'


Ir arriba
cURL


curl --location --request GET 'http://<dominio>:<puerto>/tipos/potenciales' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'






Importante: no olvidar headers






Ir arriba
Ejemplo de request URL


http://192.168.293.365:8071/tipos/potenciales'


Ir arriba
Ejemplo de cURL


curl --location --request GET 'http://192.168.293.365:8071/tipos/potenciales' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'


Ir arriba
Responses


200 Ha ido correctamente


{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
         {
            "codigo": "R",
            "descripcion": "Real"
        }
    ]
}


500 Ha ocurrido un error


{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}






Ir arriba
[GET] /tipos/riesgos


Ir arriba
Descripción


Devuelve un listado con los tipos de riesgos.






Ir arriba
Petición






GET /tipos/riesgos






Ir arriba
Request URL


http://<dominio>:<puerto>/tipos/riesgos'


Ir arriba
cURL


curl --location --request GET 'http://<dominio>:<puerto>/tipos/riesgos' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'






Importante: no olvidar headers






Ir arriba
Ejemplo de request URL


http://192.168.293.365:8071/tipos/riesgos'


Ir arriba
Ejemplo de cURL


curl --location --request GET 'http://192.168.293.365:8071/tipos/riesgos' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'


Ir arriba
Responses


200 Ha ido correctamente


{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
         {
            "codigo": "D",
            "descripcion": "Deudor"
        }
    ]
}


500 Ha ocurrido un error


{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}






























































Ir arriba
Modificaciones


Ir arriba
[POST] /modificaciones/search


Ir arriba
Descripción


Búsqueda de modificaciones con filtros. Devuelve un listado con las modificaciones de facturas que cumplen los filtros de búsqueda.






Ir arriba
Petición






POST /modficaciones/search






Ir arriba
Petición con opciones de paginación






POST /modficaciones/search?PageSize=<size>&PageNumber=<number>






Ir arriba
Request URL


http://<dominio>:<puerto>/modificaciones/search'


Ir arriba
Request URL con opciones de paginación


http://<dominio>:<puerto>/modificaciones/search?PageSize=<size>&PageNumber=<number>'















Parámetro




Descripción


Obligatorio
Ejemplo




<size>


Número de elementos por página




No




10






<number>


Número de página




No




2










Ir arriba
cURL


curl --location --request POST 'http://<dominio>:<puerto>/modificaciones/search' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '<body>'


Ir arriba
cURL con opciones de paginación


curl --location --request POST 'http://<dominio>:<puerto>/modificaciones/search?PageSize=<size>&PageNumber=<number>' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '<body>'














Header




Descripción


Obligatorio




<body>


Conjunto de filtros a aplicar sobre la búsqueda




No










Ir arriba
Body (request)


{
  "generales": [
    {
      "campo": <campo>,
      "valores": <valores>,
      "codigo": <filtro>
    }
  ]
}















Parámetro




Descripción


Obligatorio
Tipo parámetro




<campo>


Campo por el que se va a aplicar el filtro dentro del bloque al que corresponde. En este caso, sobre actos




Sí




Cadena de caracteres






<valores>


Lista de valores




Sí




Lista de valores






<filtro>


Tipo de filtro a aplicar. Consultar petición [GET] /filtros para más información




Sí




Cadena de caracteres












 




¡Importante!


Al ser una petición POST, tenemos que incluir un header adicional (Content-Type) para indicar el formato del body. Para esta petición es application/json.


No olvidar el token






Ir arriba
Ejemplo de request URL


http://192.168.293.365:8071/modificaciones/search'


Ir arriba
Ejemplo de request URL con opciones de paginación


http://192.168.293.365:8071/modificaciones/search?PageSize=10&PageNumber=2'


Ir arriba
Ejemplo de body


{
  "generales": [
    {
      "campo": "fecha",
      "valores": [
        "11/02/2023"
      ],
      "codigo": "EQ"
    },
    {
      "campo": "codigoUsuario",
      "valores": [
        "Admin"
      ],
      "codigo": "EQ"
    },
    {
      "campo": "tipoModificacion",
      "valores": [
        "1"
      ],
      "codigo": "EQ"
    },
    {
      "campo": "empresa",
      "valores": [
        "E1"
      ],
      "codigo": "EQ"
    },
    {
      "campo": "numeroPresupuesto",
      "valores": [
        "424"
      ],
      "codigo": "EQ"
    },
    {
      "campo": "numeroOdc",
      "valores": [
        "424"
      ],
      "codigo": "EQ"
    },
    {
      "campo": "numeroFactura",
      "valores": [
        "424"
      ],
      "codigo": "EQ"
    },
    {
      "campo": "numeroOrden",
      "valores": [
        "C",
        "A"
      ],
      "codigo": "EQ"
    }
  ]
}















Campo




Descripción


Obligatorio
Tipo parámetro






“fecha”




Filtro sobre el la fecha de la modificacion




No




Cadena de caracteres.








“codigoUsuario”




Filtro sobre el codigo de usuario




No




Cadena de caracteres.








“tipoModificacion”




Filtro sobre el tipo de modificacion




No




Cadena de caracteres.








“empresa”




Filtro sobre el codigo de empresa




No




Cadena de caracteres.








“numeroPresupuesto”




Filtro sobre el numero de presupuesto




No




Cadena de caracteres.








“numeroOdc”




Filtro sobre el numero de Odc




No




Cadena de caracteres.








“numeroFactura”




Filtro sobre el numero de la factura




No




Cadena de caracteres.








“numeroOrden”




Filtro sobre el numero de el orden




No




Cadena de caracteres.










Ir arriba
Ejemplo de cURL


curl --location --request POST 'http://192.168.293.365:8071/modificaciones/search' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH' \
--header 'Content-Type: application/json' \
--data-raw '{
  {
  "generales": [
      "campo": "fecha",
      "valores": [
        "11/02/2023"
      ],
      "codigo": "EQ"
    },
    {
      "campo": "codigoUsuario",
      "valores": [
        "Admin"
      ],
      "codigo": "EQ"
    },
    {
      "campo": "tipoModificacion",
      "valores": [
        "1"
      ],
      "codigo": "EQ"
    },
    {
      "campo": "empresa",
      "valores": [
        "E1"
      ],
      "codigo": "EQ"
    },
    {
      "campo": "numeroPresupuesto",
      "valores": [
        "424"
      ],
      "codigo": "EQ"
    },
    {
      "campo": "numeroOdc",
      "valores": [
        "424"
      ],
      "codigo": "EQ"
    },
    {
      "campo": "numeroFactura",
      "valores": [
        "424"
      ],
      "codigo": "EQ"
    },
    {
      "campo": "numeroOrden",
      "valores": [
        "C",
        "A"
      ],
      "codigo": "EQ"
    }
  ]
 }'


Ir arriba
Ejemplo de cURL con opciones de paginación


curl --location --request POST 'http://192.168.293.365:8071/modificaciones/search?PageSize=10&PageNumber=2' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH' \
--header 'Content-Type: application/json' \
--data-raw '{
  "generales": [
    {
      "campo": "fecha",
      "valores": [
        "11/02/2023"
      ],
      "codigo": "EQ"
    },
    {
      "campo": "codigoUsuario",
      "valores": [
        "Admin"
      ],
      "codigo": "EQ"
    },
    {
      "campo": "tipoModificacion",
      "valores": [
        "1"
      ],
      "codigo": "EQ"
    },
    {
      "campo": "empresa",
      "valores": [
        "E1"
      ],
      "codigo": "EQ"
    },
    {
      "campo": "numeroPresupuesto",
      "valores": [
        "424"
      ],
      "codigo": "EQ"
    },
    {
      "campo": "numeroOdc",
      "valores": [
        "424"
      ],
      "codigo": "EQ"
    },
    {
      "campo": "numeroFactura",
      "valores": [
        "424"
      ],
      "codigo": "EQ"
    },
    {
      "campo": "numeroOrden",
      "valores": [
        "C",
        "A"
      ],
      "codigo": "EQ"
    }
  ]
}'


Ir arriba
Responses validaciones de campos


400 Valor no válido para el campo ‘codigo’


{
    "statusCode": 400,
    "message": "Filtro 'X' no contemplado. [GET] /filtros para más información",
    "data": null
}


400 Valor no válido para el campo ‘campo’


{
    "statusCode": 400,
    "message": "Campo 'X' no contemplado",
    "data": null
}


400 Lista de valores vacía


{
    "statusCode": 400,
    "message": "Se deben informar valores para el tipo de filtro 'EQ'",
    "data": null
}


400 Lista de ‘valores’ con valor vacío


{
    "statusCode": 400,
    "message": "El valor no puede ser nulo",
    "data": null
}


400 Filtro ‘Between’ con más de dos valores


{
    "statusCode": 400,
    "message": "El filtro 'BT' tiene que tener únicamente dos valores",
    "data": null
}


Ir arriba
Headers responses


En esta petición, además de devolver un listado con las facturas emitidas que cumplen los filtros de búsqueda, en la cabecera de la respuesta se devuelve el parámetro X-Pagination con la siguiente información:


{"TotalCount":<total>,"PageSize":<size>,"CurrentPage":<current_page>,"TotalPages":<total_pages>,"HasNextPage":<has_next_page>,"HasPreviousPage":<has_previous_page>,"NextPageUrl":<next_url>,"PreviousPageUrl":<previous_url>}













Parámetro




Descripción






<total>


Número total de facturas emitidas encontradas en la búsqueda






<size>


Número de elementos por página






<current_page>


Página actual






<total_pages>


Número total de páginas






<has_next_page>


Indica si hay página siguiente






<has_previous_page>


Indica si hay página anterior






<next_url>


URL de la siguiente página






<previous_url>


URL de la página anterior










Ir arriba
Ejemplo headers responses


{"TotalCount":2432,"PageSize":10,"CurrentPage":1,"TotalPages":244,
"HasNextPage":true,"HasPreviousPage":false,"NextPageUrl":"","PreviousPageUrl":""}


Ir arriba
Responses


200 Ha ido correctamente


{
  "statusCode": 200,
  "message": "Petición finalizada correctamente",
  "data": [
    {
      "codUsuario": "Admin",
      "tipoModificacion": {
        "codigo": "1",
        "descripcion": "Alta"
      },
      "fecha": "25/01/2024 0:00:00",
      "empresa": {
        "codigo": "E1",
        "descripcion": "Empresa 1"
      },
      "numeroPresupuesto": "00065",
      "numeroOdc": "00045",
      "numeroFactura": "014/24",
      "numeroOrden": "00005",
      "observacion": "Observaciones"
    }
  ]
}


500 Ha ocurrido un error


{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}



Ir arriba
Facturas Recibidas






Ir arriba
[DELETE] /facturas/recibidas/{id}/lineas/{idLinea}/gastosEstimados


Ir arriba
Descripción


Desasocia la factura recibida a la factura estimados






Ir arriba
Petición






DELETE /facturas/recibidas/<id>/lineas/<idLinea>/gastosEstimados



















Parámetro




Descripción


Obligatorio
Ejemplo




<id>


Identificador de la factura




Sí




1007






<idLinea>


Identificador de la linea




Sí




5










Ir arriba
Request URL


http://<dominio>:<puerto>/facturas/recibidas/<id>/lineas/<idLinea>/gastosEstimados'


Ir arriba
cURL


curl --location --request DELETE'http://<dominio>:<puerto> /facturas/recibidas/id/lineas/idLinea/gastosEstimados' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '<body>'


¡Importante!


Al ser una petición DELETE, tenemos que incluir un header adicional (Content-Type) para indicar el formato del body. Para esta petición es application/json


No olvidar el token






Ir arriba
Ejemplo de request URL


http://192.168.293.365:8071/facturas/recibidas/1007/lineas/5/gastosEstimados'


Ir arriba
Ejemplo de cURL


curl --location --request DELETE'http://192.168.293.365:8071/facturas/recibidas/1007/lineas/5/gastosEstimados' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'


Ir arriba
Responses


200 Ha ido correctamente


{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": null
}


404 No se ha encontrado la factura recibida


{
    "statusCode": 404,
    "message": "No se ha encontrado la factura recibida",
    "data": null
}




404 No se ha encontrado la linea


{
    "statusCode": 404,
    "message": "No se ha encontrado la linea",
    "data": null
}




409 Confilcto, la linea no pertenece a la factura recibida


{
    "statusCode": 409,
    "message": "La linea no pertenece a esa factura recibida",
    "data": null
}


500 Ha ocurrido un error


{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}







Ir arriba
[GET] /facturas/recibidas/{id}


Ir arriba
Descripción


Obtiene una factura recibida por el id.






Ir arriba
Petición






GET /facturas/recibidas/<id>



















Parámetro




Descripción


Obligatorio
Ejemplo




<id>


Identificador de la linea




Sí




1007










Ir arriba
Request URL


http://<dominio>:<puerto>/facturas/recibidas/<id>'


Ir arriba
cURL


curl --location --request GET 'http://<dominio>:<puerto>/facturas/recibidas/<id>' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'






Importante: no olvidar headers






Ir arriba
Ejemplo de request URL


http://192.168.293.365:8071/facturas/recibidas/1007'


Ir arriba
Ejemplo de cURL


curl --location --request GET 'http://192.168.293.365:8071/facturas/recibidas/1007' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'


Ir arriba
Responses


200 Ha ido correctamente


{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "id": 5,
            "numeroFactura": "4123111",
            "numeroCargo": "F123",
            "fechaEstadoFactura": "20/06/2025",
            "fechaVencimiento": "01/01/2027",
            "fechaRecepcion": "10/07/2023",
            "fechaPago": "12/12/2022",
            "fechaFactura": "12/03/2024",
            "fechaContabilizacion": "20/06/2025",
            "idContacto": 1234,
            "baseImponible": 100,
            "importeTasas": 150,
            "totalFactura": 250,
            "iva": 21,
            "totalIva": 345,
            "ivaRet": 0,
            "totalIvaRet": 345,
            "Irpf": 0,
            "totalIrpf": 345,
            "baseImponible": 100,
            "observaciones": "Factura de ejemplo",
            "empresa": {
                "codigo": "EM1",
                "descripcion": "Empresas"
            },
            "estadoFactura": { 
                "codigo": "0", 
                "descripcion": "Clientes Morosos" 
            },
            "seccion": { 
                "codigo": "40",  
                "descripcion": "Nota factura" 
            },
            "pais": { 
                "codigo": "ES", 
                "descripcion": "España" 
            },
            "moneda": { 
                "codigo": "EUR", 
                "descripcion": "Euro" 
            }
        }
    ]
}


404 No se ha encontrado la factura recibida por id


{
    "statusCode": 404,
    "message": "No se ha encontrado la factura recibida",
    "data": null
}


500 Ha ocurrido un error


{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}



Ir arriba
[POST] /facturas/recibidas


Creación de una nueva factura recibida. Devuelve el identificador de la factura creada.






Ir arriba
Petición






POST /facturas/recibidas






Ir arriba
Request URL


http://<dominio>:<puerto>/facturas/recibidas'


Ir arriba
cURL


curl --location --request POST 'http://<dominio>:<puerto>/facturas/recibidas' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '<body>'














Header




Descripción


Obligatorio




<body>


Información de la factura recibida que queremos crear




Sí










Ir arriba
Body (request)


{
  "empresa": <empresa>,
  "numeroFactura": <numeroFactura>,
  "numeroCargo": <numeroCargo>,
  "idContacto": <idContacto>,
  "estadoFactura": <estadoFactura>,
  "fechaEstadoFactura": <fechaEstadoFactura>,
  "fechaVencimiento": <fechaVencimiento>,
  "fechaRecepcion": <fechaRecepcion>,
  "fechaPago": <fechaPago>,
  "fechaFactura": <fechaFactura>,
  "fechaContabilizacion": <fechaContabilizacion>,
  "pais": <pais>,
  "moneda": <moneda>,
  "importeHonorarios": <importeHonorarios>,
  "importeTasas": <importeTasas>
  "observaciones": <observaciones>
}

















Parámetro




Descripción


Obligatorio
Tipo parámetro
Longitud máxima parámetro
Ejemplo




<empresa>


Empresa asociada a la factura. Consultar petición [GET] /empresas para más información




Sí




Cadena de caracteres




10 caracteres




22D






<numeroFactura>


Número de la factura




No




Cadena de caracteres




30 caracteres




578549






<numeroCargo>


Número de la cargo




No




Cadena de caracteres




30 caracteres




F232






<idContacto>


Identificador del contacto al que pertenece la factura




Sí




Numérico


–


6450






<estadoFactura>


Estado de la factura




No


Cadena de caracteres.

16




<FechaEstadoFactura>


Fecha del estado de la factura




No




Cadena de caracteres.




–




12/04/2023






<fechaVencimiento>


Fecha de vencimiento de la factura




No




Formato: Fecha con/sin hora




–




20/06/2022






<fechaRecepcion>


Fecha de recepcion de la factura




No




Formato: Fecha con/sin hora




–




30/04/2022






<fechaPago>


Fecha de pago de la factura




No




Formato: Fecha con/sin hora




–




26/10/2022






<fechaFactura>


Fecha de la factura




No




Formato: Fecha con/sin hora




–




30/04/2022






<fechaContabilizacion>


Fecha de contabilización de la factura




No




Formato: Fecha con/sin hora


–


31/12/2022






<pais>


País de la factura. Consultar petición [GET] /países para más información




Sí




Cadena de caracteres




2 caracteres




ES






<moneda>


Moneda de la factura. Consultar petición [GET] /monedas para más información




Sí




Cadena de caracteres




3 caracteres




EUR






<importeHonorarios>


Importe de los honorarios




No




Numérico con decimales




Máximo 4 decimales




100.50






<importeTasas>


Importe de las tasas




No




Numérico con decimales




Máximo 4 decimales




504.22






<observaciones>


Observaciones de la factura




No




Cadena de caracteres


–


Factura de ejemplo












 




¡Importante!


Al ser una petición POST, tenemos que incluir un header adicional (Content-Type) para indicar el formato del body. Para esta petición es application/json


No olvidar el token






Ir arriba
Ejemplo de request URL


http://192.168.293.365:8071/facturas/recibidas'


Ir arriba
Ejemplo de body


{
  "empresa": "E1",
  "numeroFactura": "12345",
  "numeroCargo": "F232",
  "idContacto": 17,
  "estadoFactura": "16",
  "fechaEstadosFactura": "03/02/2023 0:00:00",
  "fechaVencimiento": "20/12/2023 0:00:00",
  "fechaRecepcion": "10/04/2023 0:00:00",
  "fechaPago": "22/01/2023 0:00:00",
  "fechaFactura": "03/02/2023 0:00:00",
  "fechaContabilizacion": "03/02/2023 18:30:00",
  "pais": "ES",
  "moneda": "EUR",
  "importeHonorarios": 100.10,
  "importeTasas": 150.40,
  "observaciones": "Factura de ejemplo"
}


Ir arriba
Ejemplo de cURL


curl --location --request POST 'http://192.168.293.365:8071/facturas/recibidas' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH' \
--header 'Content-Type: application/json' \
--data-raw '{
  "empresa": "E1", "numeroFactura": "12345",
  "numeroCargo": "F232", "idContacto": 17,
  "estadoFactura": "16",
  "fechaEstadosFactura": "03/02/2023 0:00:00",
  "fechaVencimiento": "20/12/2023 0:00:00",
  "fechaRecepcion": "10/04/2023 0:00:00",
  "fechaPago": "22/01/2023 0:00:00", 
  "fechaFactura": "03/02/2023 0:00:00", 
  "fechaContabilizacion": "03/02/2023 18:30:00", 
  "pais": "ES", 
  "moneda": "EUR", 
  "importeHonorarios": 100.10, 
  "importeTasas": 150.40, 
  "observaciones": "Factura de ejemplo"
}'


Ir arriba
Responses validaciones de campos


404 Valor no válido para el campo ‘empresa’


{
    "statusCode": 404,
    "message": "Valor 'X' no encontrado para el campo 'empresa'. [GET] /empresas para más información",
    "data": null
}


404 Valor no válido para el campo ‘pais’


{
    "statusCode": 404,
    "message": "Valor 'X' no encontrado para el campo 'pais'. [GET] /paises para más información",
    "data": null
}


404 Valor no válido para el campo ‘moneda’


{
    "statusCode": 404,
    "message": "Valor 'X' no encontrado para el campo 'moneda'. [GET] /monedas para más información",
    "data": null
}


404 Valor no válido para el campo ‘idContacto’


{
    "statusCode": 404,
    "message": "Valor 'X' no encontrado para el campo 'IdContacto'. [GET] /contactos/search para más información",
    "data": null
}


400 Valor fecha no válido


{
    "statusCode": 400,
    "message": "Valor '30/23/2022' no tiene un formato de fecha válido para el campo 'FechaFactura'",
    "data": null
}


Ir arriba
Responses


200 Ha ido correctamente


{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": 3992
}


500 Ha ocurrido un error


{
    "statusCode": 500,
    "message": <mensaje_error>,
    "data": null
}


Ir arriba
[PUT] /facturas/recibidas/{id}


Ir arriba
Descripción


Modificación de una factura recibida.






Ir arriba
Petición


PUT /facturas/recibidas/<id>













 


Parámetro


 


Descripción


 


Obligatorio

 


Ejemplo





 


<id>

 


Identificador de la factura


 

 


Sí


 

 


6450


 







Request URL




http://<dominio>:<puerto>/facturas/recibidas/<id>'


Ir arriba
cURL


curl --location --request PUT 'http://<dominio>:<puerto>/facturas/recibidas/<id>' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '<body>'














Header




Descripción


Obligatorio




<body>


Información de la factura que queremos modificar




Sí










Ir arriba
Body (request)


{
  "empresa": <empresa>, 
  "numeroFactura": <numeroFactura>, 
  "numeroCargo": <numeroCargo>, 
  "idContacto": <idContacto>, 
  "estadoFactura": <estadoFactura>, 
  "fechaEstadoFactura": <fechaEstadoFactura>, 
  "fechaVencimiento": <fechaVencimiento>, 
  "fechaRecepcion": <fechaRecepcion>, 
  "fechaPago": <fechaPago>, 
  "fechaFactura": <fechaFactura>, 
  "fechaContabilizacion": <fechaContabilizacion>, 
  "pais": <pais>, 
  "moneda": <moneda>, 
  "importeHonorarios": <importeHonorarios>, 
  "importeTasas": <importeTasas> ,
  "observaciones": <observaciones>
}

















Parámetro




Descripción


Obligatorio
Tipo parámetro
Longitud máxima parámetro
Ejemplo




<empresa>


Codigo de la empresa




No




Cadena de caracteres




10 caracteres




Empresa1








<numeroFactura>




Numero de la factura




No




Numeros enteros




10 enteros


2345




<numeroCargo>
Numero del cargo
No


Cadena de caracteres




10 caracteres




F234






<idContacto>


Id del contacto asociado a la factura recibida




No




Numeros enteros


10 caracteres


12






<estadoFactura>


Codigo del estado de la factura




No




Cadena de caracteres




10 caracteres




16






<fechaEstadoFactura>


Fecha del estado de la factura




No




Fecha sin hora









16/01/2024






<fechaVencimiento>


Fecha de vencimiento de la factura




No




Fecha sin hora









11/08/2023






<fechaRecepcion>


Fecha de recepcion de la factura




No




Fecha sin hora









26/07/2023






<fechaPago>


Fecha de pago de la factura




No




Fecha sin hora









14/03/2023






<fechaFactura>


Fecha de la factura recibida




No




Fecha sin hora









11/05/2023






<fechaContabilizacion>


Fecha de contabilizacion




No




Fecha sin hora









04/04/2023






<pais>


Codigo del pais




No




Cadena de caracteres




2 caracteres




ES






<moneda>


Codigo de la moneda




No




Cadena de caracteres




10 caracteres




EUR






<importeHonorarios>


Cantidad del importe de los honorarios




No




Numeros enteros




10 caracteres




100






<importeTasas>


Cantidad del importe de las tasas




No




Numeros enteros




10 caracteres




150






<observaciones>


Observacion de la factura recibida




No




Cadena de caracteres




50 caracteres




Factura de ejemplo












 








¡Importante!


Al ser una petición PUT, tenemos que incluir un header adicional (Content-Type) para indicar el formato del body. Para esta petición es application/json.


No olvidar el token






Ir arriba
Ejemplo de request URL


http://192.168.293.365:8071/facturas/recibidas/6450'


Ir arriba
Ejemplo de body


{
  "empresa": "E1", 
  "numeroFactura": "1234", 
  "numeroCargo": "F234", 
  "idContacto": 17, 
  "estadoFactura": "16", 
  "fechaEstadoFactura": "12/10/2023", 
  "fechaVencimiento": "22/11/2023", 
  "fechaRecepcion": "10/07/2023", 
  "fechaPago": "18/12/2023", 
  "fechaFactura": "02/01/2023", 
  "fechaContabilizacion": "16/09/2023", 
  "pais": "ES", 
  "moneda": "EUR", 
  "importeHonorarios": 100, 
  "importeTasas": 150, 
  "observaciones": "Factura de ejemplo"
}


Ir arriba
Ejemplo de cURL


curl --location --request PUT 'http://192.168.293.365:8071/facturas/6450' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH' \
--header 'Content-Type: application/json' \
--data-raw '{
  "empresa": "E1", 
  "numeroFactura": "1234", 
  "numeroCargo": "F234", 
  "idContacto": 17, 
  "estadoFactura": "16", 
  "fechaEstadoFactura": "12/10/2023", 
  "fechaVencimiento": "22/11/2023", 
  "fechaRecepcion": "10/07/2023", 
  "fechaPago": "18/12/2023", 
  "fechaFactura": "02/01/2023", 
  "fechaContabilizacion": "16/09/2023", 
  "pais": "ES", 
  "moneda": "EUR", 
  "importeHonorarios": 100, 
  "importeTasas": 150, 
  "observaciones": "Factura de ejemplo"
}'


Ir arriba
Responses


200 Ha ido correctamente


{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": null
}


404 No se ha encontrado el expediente


{
    "statusCode": 404,
    "message": "No se ha encontrado el expediente",
    "data": null
}


500 Ha ocurrido un error


{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}






Ir arriba
[GET] /facturas/recibidas/{id}/lineas


Ir arriba
Descripción


Obtiene las líneas asociadas a una factura.






Ir arriba
Petición






GET /facturas/recibidas/<id>/lineas



















Parámetro




Descripción


Obligatorio
Ejemplo




<id>


Identificador de la linea




Sí




1007










Ir arriba
Request URL


http://<dominio>:<puerto>/facturas/recibidas/<id>/lineas'


Ir arriba
cURL


curl --location --request GET 'http://<dominio>:<puerto>/facturas/recibidas/<id>/lineas' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'






Importante: no olvidar headers






Ir arriba
Ejemplo de request URL


http://192.168.293.365:8071/facturas/recibidas/1007/lineas'


Ir arriba
Ejemplo de cURL


curl --location --request GET 'http://192.168.293.365:8071/facturas/recibidas/1007/lineas' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'


Ir arriba
Responses


200 Ha ido correctamente


{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "id": 5,
            "descripcion": "Esto es una nueva linea",
            "cantidad": "2.0",
            "importe": "4756.23",
            "tasa": "2345",
            "otrosNoImponible": "2345.34",
            "facturarConIva": true,
            "observaciones": "Observaciones de la linea",
            "departamento": {
                "codigo": "SIGNO",
                "descripcion": "Signos distintivos"
            },
            "gastos": { 
                "codigo": "TASAS", 
                "descripcion": "Tasas" 
            },
            "departamento": { 
                "codigo": "PATENTES",  
                "descripcion": "Patentes" 
            },
            "articulo": { 
                "codigo": "PATENTES", 
                "descripcion": "Patentes" 
            },
        }
    ]
}


404 No se ha encontrado la linea asociada a la factura recibida


{
    "statusCode": 404,
    "message": "No se ha encontrado la linea asociada a la factura",
    "data": null
}


500 Ha ocurrido un error


{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}





Ir arriba
[DELETE] /facturas/recibidas/{id}/lineas/{idLinea}


Ir arriba
Descripción


Elimina la linea asociada a una factura






Ir arriba
Petición






DELETE /facturas/recibidas/<id>/lineas/<idLinea>



















Parámetro




Descripción


Obligatorio
Ejemplo




<id>


Identificador de la factura




Sí




1007






<idLinea>


Identificador de la linea




Sí




5










Ir arriba
Request URL


http://<dominio>:<puerto>/facturas/recibidas/<id>/lineas/<idLinea>'


Ir arriba
cURL


curl --location --request DELETE'http://<dominio>:<puerto> /facturas/recibidas/id/lineas/idLinea' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '<body>'


¡Importante!


Al ser una petición DELETE, tenemos que incluir un header adicional (Content-Type) para indicar el formato del body. Para esta petición es application/json


No olvidar el token






Ir arriba
Ejemplo de request URL


http://192.168.293.365:8071/facturas/recibidas/1007/lineas/5'


Ir arriba
Ejemplo de cURL


curl --location --request DELETE'http://192.168.293.365:8071/facturas/recibidas/1007/lineas/5' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'


Ir arriba
Responses


200 Ha ido correctamente


{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": null
}


404 No se ha encontrado la factura recibida


{
    "statusCode": 404,
    "message": "No se ha encontrado la factura recibida",
    "data": null
}




404 No se ha encontrado la linea


{
    "statusCode": 404,
    "message": "No se ha encontrado la linea",
    "data": null
}




409 Confilcto, la linea no pertenece a la factura recibida


{
    "statusCode": 409,
    "message": "La linea no pertenece a esa factura recibida",
    "data": null
}




409 Conflicto, la linea esta asociada a un gasto de una factura emitida


{
    "statusCode": 409,
    "message": "No se puede eliminar la linea de la factura porque esta asociada a un gasto de una factura emitida",
    "data": null
}


500 Ha ocurrido un error


{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}




Ir arriba
[GET] /facturas/recibidas/{id}/lineas/{idLinea}/expedientes


Ir arriba
Descripción


Obtiene los expedientes asociadas a una linea de una factura, si desea obtener mas información del expediente utilice el método [GET] /expedientes/{id} .






Ir arriba
Petición






GET /facturas/recibidas/<id>/lineas/<idLinea>/expedientes



















Parámetro




Descripción


Obligatorio
Ejemplo




<id>


Identificador de la factura




Sí




1007






<idLinea>


Identificador de la linea




Sí




5










Ir arriba
Request URL


http://<dominio>:<puerto>/facturas/recibidas/<id>/lineas/<idLinea>/expedientes'


Ir arriba
cURL


curl --location --request GET 'http://<dominio>:<puerto>/facturas/recibidas/<id>/lineas/<idLinea>/expedientes' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'






Importante: no olvidar headers






Ir arriba
Ejemplo de request URL


http://192.168.293.365:8071/facturas/recibidas/1007/lineas/5/expedientes'


Ir arriba
Ejemplo de cURL


curl --location --request GET 'http://192.168.293.365:8071/facturas/recibidas/1007/lineas/5/expedientes' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'


Ir arriba
Responses


200 Ha ido correctamente


{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "id": 5
        }
    ]
}


404 No se ha encontrado la factura recibida


{
    "statusCode": 404,
    "message": "No se ha encontrado la factura recibida",
    "data": null
}




404 No se ha encontrado la linea


{
    "statusCode": 404,
    "message": "No se ha encontrado la linea",
    "data": null
}




409 No se ha encontrado la linea asociada a la factura recibida


{
    "statusCode": 409,
    "message": "La linea no pertenece a esa factura recibida",
    "data": null
}


500 Ha ocurrido un error


{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}




Ir arriba
[POST] /facturas/recibidas/{id}/lineas/{idLinea}/expedientes


Ir arriba
Descripción


Asocia un expediente a un artículo asociado a una factura. Para ver los expedientes asociados a un articulo utilice el método [GET] /expedientes/{id} .






Ir arriba
Petición






POST /facturas/recibidas/<id>/lineas/<idLinea>/expedientes



















Parámetro




Descripción


Obligatorio
Ejemplo




<id>


Identificador de la factura




Sí




1007






<idLinea>


Identificador de la linea




Sí




5










Ir arriba
Request URL


http://<dominio>:<puerto>/facturas/recibidas/<id>/lineas/<idLinea>/expedientes'


Ir arriba
cURL


curl --location --request POST 'http://<dominio>:<puerto> /facturas/recibidas/id/lineas/idLinea/expedientes' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '<body>'


¡Importante!


Al ser una petición POST, tenemos que incluir un header adicional (Content-Type) para indicar el formato del body. Para esta petición es application/json


No olvidar el token






Ir arriba
Ejemplo de request URL


http://192.168.293.365:8071/facturas/recibidas/1007/lineas/5/expedientes'


Ir arriba
Ejemplo de cURL


curl --location --request POST 'http://192.168.293.365:8071/facturas/recibidas/1007/lineas/5/expedientes' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'


Ir arriba
Responses


200 Ha ido correctamente


{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": null
}


404 No se ha encontrado la factura recibida


{
    "statusCode": 404,
    "message": "No se ha encontrado la factura recibida",
    "data": null
}




404 No se ha encontrado la linea


{
    "statusCode": 404,
    "message": "No se ha encontrado la linea",
    "data": null
}




409 No se ha encontrado la linea asociada a la factura recibida


{
    "statusCode": 409,
    "message": "La linea no pertenece a esa factura recibida",
    "data": null
}




409 No se ha encontrado la linea asociada a la factura recibida


{
    "statusCode": 409,
    "message": "No se ha encontrado el expediente",
    "data": null
}




409 No se ha encontrado la linea asociada a la factura recibida


{
    "statusCode": 409,
    "message": "Ya está asociado el expediente a la línea",
    "data": null
}


500 Ha ocurrido un error


{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}





Ir arriba
Tareas


Ir arriba
[GET] /tareas :new:


Ir arriba
Descripción


Devuelve un listado con las tareas disponibles.






Ir arriba
Petición






GET /tareas






Ir arriba
Request URL


http://<dominio>:<puerto>/tasas'


Ir arriba
cURL


curl --location --request GET 'http://<dominio>:<puerto>/tasas' \
--header 'accept-language: <idioma>' \
--header 'Authorization: Bearer <token>'






Importante: no olvidar headers






Ir arriba
Ejemplo de request URL


http://192.168.293.365:8071/tareas'


Ir arriba
Ejemplo de cURL


curl --location --request GET 'http://192.168.293.365:8071/tareas' \
--header 'accept-language: es' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI5ZTI5ZDA1Yi0zMTNjLTQ2MjNzUyNzg2OHH'


Ir arriba
Responses


200 Ha ido correctamente


{
    "statusCode": 200,
    "message": "Petición finalizada correctamente",
    "data": [
        {
            "codigo": "VENC PS4",
            "descripcion": "Vencimiento Ley PS4 - P"
        },
        { 
             "codigo": "WOPRSOH", 
             "descripcion": "Presentación de solicitud - H" 
        }
    ]
}


500 Ha ocurrido un error


{
  "statusCode": 500,
  "message": <mensaje_error>,
  "data": null
}








 
















































Ir arriba
	


	
	
	



			

				

					
					

						
					

															
										
				

			

			

			
				
				
		


						

				

					Artículo Anterior

					

												

							Contactos