Los terceros, son los exportadores/proveedores/compradores que se deben agregan al encabezado del formulario como dato obligatorio para crear un documento.
Parámetro | Valor |
|---|---|
Nombre servicio | createThirdParty |
Tipo método | POST |
URL | https://gorgeous-dust-0seusmuxapkp.vapor-farm-b1.com/api/auth/thirdParty/createThirdParty |
Content type | application/json |
POST/createThirdParty
Parámetro | Tipo | Longitud | Obligatorio | Descripción |
|---|---|---|---|---|
nit | string | 20 | Si | Código asignado para la identificación del contribuyente. |
internal_code | string | 80 | Si | Código interno con que se identifica el tercero |
business_name | string | 80 | Si | Razón social del tercero |
type | String | 15 | Si | Indica si el proveedor es Nacional o extranjero |
qualifiedUser_id | integer | Si | Identificación interna del usuario calificado | |
address | string | 150 | No | Dirección del tercero |
phone | string | 80 | No | Teléfono del tercero |
acronym | string | 80 | No | Siglas con que se identifica el tercero |
alias | string | 80 | No | Seudónimo con que identifica el tercero |
Importante: El servicio está requiriendo la identificación interna del usuario, el cual en el caso de portozual sería el 214.
Ejemplo:
Cuerpo de la petición
{
"nit": "800149695",
"internal_code": "1234",
"business_name": "DROG Y FARMACIAS CRUZ VERDE",
"type": "Nacional",
"qualifiedUser_id": 214
}
Respuesta:
{
"status": {
"code": 200,
"message": "Procesado con éxito",
"data": {
"id": 299,
"qualifiedUser_id": 214,
"nit": "800149695",
"type": "Nacional",
"internal_code": "1234",
"business_name": "DROG Y FARMACIAS CRUZ VERDE",
"address": null,
"phone": null,
"acronym": null,
"alias": null
}
}
}
5.1 Actualizar terceros
Parámetro | Valor |
|---|---|
Nombre servicio | updateThirdParty |
Tipo método | POST |
URL | https://gorgeous-dust-0seusmuxapkp.vapor-farm-b1.com/api/auth/thirdParty/updateThirdParty |
Content type | application/json |
POST/updateThirdParty
Parámetro | Tipo | Longitud | Obligatorio | Descripción |
|---|---|---|---|---|
id | integer | Si | id interno del tercero | |
nit | string | 20 | No | Código asignado para la identificación del contribuyente. |
internal_code | string | 80 | No | Código interno con que se identifica el tercero |
business_name | string | 80 | No | Razón social del tercero |
type | String | 15 | No | Indica si el proveedor es Nacional o extranjero |
qualifiedUser_id | integer | No | Identificación interna del usuario calificado | |
address | string | 150 | No | Dirección del tercero |
phone | string | 80 | No | Teléfono del tercero |
acronym | string | 80 | No | Siglas con que se identifica el tercero |
alias | string | 80 | No | Seudónimo con que identifica el tercero |
Para consultar el id interno del tercero, se debe consultar el servicio de getThirdParties
Ejemplo:
Cuerpo de la petición
{
"id": 299,
"alias": "CRUZ VERDE"
}
Respuesta:
{
"status": {
"code": 200,
"message": "Procesado con éxito",
"data": {
"id": 299,
"qualifiedUser_id": 214,
"nit": "800149695",
"type": "Nacional",
"internal_code": "1234",
"business_name": "DROG Y FARMACIAS CRUZ VERDE",
"address": null,
"phone": null,
"acronym": null,
"alias": "CRUZ VERDE"
}
}
}
5.2. Consultar terceros
Se puede consultar todos los productos creados hasta el momento mediante el método getThirdParties
Parámetro | Valor |
|---|---|
Nombre servicio | getThirdParties |
Tipo método | GET |
URL | https://gorgeous-dust-0seusmuxapkp.vapor-farm-b1.com/api/auth/getThirdParties |
Content type | application/json |
GET/getThirdParties
Respuesta:
{
"status": {
"code": 200,
"message": "Procesado con éxito",
"data": {
"current_page": 1,
"data": [
{
"id": 299,
"qualifiedUser_id": 214,
"nit": "800149695",
"type": "Nacional",
"internal_code": "1234",
"business_name": "DROG Y FARMACIAS CRUZ VERDE",
"address": null,
"phone": null,
"acronym": null,
"alias": "CRUZ VERDE"
}
],
"first_page_url": "https://gorgeous-dust-0seusmuxapkp.vapor-farm-b1.com/api/auth/thirdParty/getThirdParties?page=1%22,
"from": 1,
"last_page": 1,
"last_page_url": "https://gorgeous-dust-0seusmuxapkp.vapor-farm-b1.com/api/auth/thirdParty/getThirdParties?page=1%22,
"links": [
{
"url": null,
"label": "« Anterior",
"active": false
},
{
"url": "https://gorgeous-dust-0seusmuxapkp.vapor-farm-b1.com/api/auth/thirdParty/getThirdParties?page=1%22,
"label": "1",
"active": true
},
{
"url": null,
"label": "Siguiente »",
"active": false
}
],
"next_page_url": null,
"path": "https://gorgeous-dust-0seusmuxapkp.vapor-farm-b1.com/api/auth/thirdParty/getThirdParties%22,
"per_page": 10,
"prev_page_url": null,
"to": 1,
"total": 1
}
}
}