Produtos e Serviços

Neste capitulo serão descritos 2 tipos de itens diferentes. Os Serviços e os Protudos. Ambos partilham de atributos iguais mas têm diferentes rotas para realizar diferentes tipos de ações.

Produtos

Obter Produtos

De modo a obter informações sobre um dado produto, poderá realizar o seguinte pedido

GET /products

Path Parameters

Name
Type
Description

filter[item_code]

String

<item_code>

{
    // Response
}

Neste, pode não indicar nenhum filtro, e obter todos os produtos disponíveis, ou então filtrar por qualquer um dos campos disponíveis, tal como no exemplo dado, e seguindo as convenções JSONAPI

Exemplo de Response
{
    "data": [
        {
            "type": "products",
            "id": "2",
            "attributes": {
                "item_code": "100",
                "item_description": "Isto é uma breve descrição",
                "sales_price": 2.0,
                "sales_price_includes_vat": false,
                "tax_code": "INT",
                "applied_tax_code": "INT",
                "notes": "Isto são notas de produtos",
                "is_merchandise": null,
                "location_in_warehouse": null,
                "sales_price_2": 4.0,
                "sales_price_3": null,
                "purchase_price": 5.0,
                "ean_barcode": "553214",
                "financial_cost": 2.0,
                "transport_cost": 1.0,
                "other_cost": 0.0,
                "customs_cost": 10.0,
                "estimated_total_cost": 18.0,
                "product_inventory_type": "P",
                "accounting_number": null,
                "service_group": null,
                "is_active": true,
                "sales_price_vat_display": 2.26,
                "sales_price_2_vat_display": 4.52,
                "sales_price_3_vat_display": null,
                "applied_tax_exemption_reason_id": null
            },
            "relationships": {
                "applied_tax_exemption_reason": {
                    "data": null
                },
                "company": {
                    "data": {
                        "type": "current_company",
                        "id": "800000046"
                    }
                },
                "item_families": {
                    "data": {
                        "type": "item_families",
                        "id": "3"
                    }
                },
                "tax_exemption_reasons": {
                    "data": null
                },
                "unit_of_measure": {
                    "data": {
                        "type": "units_of_measure",
                        "id": "5"
                    }
                }
            }
        }
    ]
}

Criar Produtos

Criar Produto

post

Criar Produto

Required scopes
This endpoint requires the following scopes:
  • : commercial
Authorizations
OAuth2authorizationCodeRequired
Authorization URL: Token URL:
Body
Responses
200

Sucesso

application/json
post
/api/products
200

Sucesso

No pedido acima, o <access_token> corresponde ao token de acesso válido devolvido pelo serviço de OAuth, e o <payload JSON> deverá ter o seguinte formato:

Serviços

Criar Serviços

No pedido acima, o <access_token> corresponde ao token de acesso válido devolvido pelo serviço de OAuth, e o <payload JSON> deverá ter o seguinte formato

Criar Serviço

post

Criar Serviço

Required scopes
This endpoint requires the following scopes:
  • : commercial
Authorizations
OAuth2authorizationCodeRequired
Authorization URL: Token URL:
Body
Responses
200

Sucesso

application/json
post
/api/services
200

Sucesso

Obter Todos os Serviços

GET /services

Path Parameters

Name
Type
Description

filter[item_code]

String

<item_code>

Obter Serviço

De modo a obter informações sobre um dado serviço, poderá realizar o seguinte pedido

Obter Todos os Serviços

get

Obter Todos os Serviços

Required scopes
This endpoint requires the following scopes:
  • : commercial
Authorizations
OAuth2authorizationCodeRequired
Authorization URL: Token URL:
Responses
200

Sucesso

application/json
get
/api/services
200

Sucesso

Associar Famílias de Itens a Produtos

Já teve de ser criado previamente uma Família de Itens.

Pode consultar mais em: Família de Itens

Atualizar Produto

patch

Atualizar Produto

Required scopes
This endpoint requires the following scopes:
  • : commercial
Authorizations
OAuth2authorizationCodeRequired
Authorization URL: Token URL:
Body
Responses
200Success
No content
patch
/api/products
200Success
No content

Associar Famílias de Itens a Serviços

Já teve de ser criado previamente uma Família de Itens.

Pode consultar mais em: Família de Itens

Atualizar Serviço

patch

Atualizar Serviço

Required scopes
This endpoint requires the following scopes:
  • : commercial
Authorizations
OAuth2authorizationCodeRequired
Authorization URL: Token URL:
Body
Responses
200Success
No content
patch
/api/services
200Success
No content

Associar Unidades de Medida a Produtos

Já teve de ser criado previamente uma Unidade de Medida.

Pode consultar mais em: Unidades de Medida

Atualizar Produto

patch

Atualizar Produto

Required scopes
This endpoint requires the following scopes:
  • : commercial
Authorizations
OAuth2authorizationCodeRequired
Authorization URL: Token URL:
Body
Responses
200Success
No content
patch
/api/products
200Success
No content

Associar Unidades de Medida a Serviços

Atualizar Produto

patch

Atualizar Produto

Required scopes
This endpoint requires the following scopes:
  • : commercial
Authorizations
OAuth2authorizationCodeRequired
Authorization URL: Token URL:
Body
Responses
200Success
No content
patch
/api/products
200Success
No content

PreviousFornecedores, Morada e E-mailNextVendas

Last updated