Exclui um item faturável do ticket

DELETE

/v1/tickets/{ticketId}/billable-items/{itemId}

Code sample: Shell / cURL

curl --request DELETE \
  --url https://public-api.mspdesk.com.br/v1/tickets/1/billable-items/512 \
  --header 'Authorization: Bearer <token>'

Escopo exigido: tickets:write. Exclusão definitiva da linha, como na aba. Item que já está em uma fatura responde 422 business_rule_violation: retire-o pela fatura.

Em ticket concluído ou fechado a resposta é 422 ticket_not_editable, e em ticket na lixeira, 422 ticket_deleted. Nenhum parâmetro de consulta é aceito.

Autorizações

• bearer

Parâmetros

Parâmetros de caminho

ticketId

required

integer format: int64

ID do ticket

Exemplo

1

itemId

required

integer format: int64

ID do item faturável

Exemplo

512

Respostas

204

O item não existe mais

Cabeçalhos

RateLimit-Limit

integer format: int32

Capacidade do balde mais restritivo consumido nesta requisição

RateLimit-Remaining

integer format: int32

Requisições restantes nesse balde

RateLimit-Reset

integer format: int32

Segundos até o balde encher de novo

400

Requisição malformada ou parâmetros de consulta inválidos

Media typeapplication/problem+json

Erro no formato RFC 9457 (application/problem+json).

object

code

required

Código estável do erro, para tratamento programático.

string

detail

required

Explicação legível deste erro específico.

string

errors

Erros de campo — presente quando a falha vem de validação de campo.

Array<object>

object

code

Código estável do erro de campo.

string

Allowed values: required too_long too_short invalid_value invalid_format unknown_field unsupported_operator unsupported_field out_of_range not_found inactive inconsistent_reference not_applicable

field

Campo com erro, em notação de ponto/colchete. Ausente quando o erro não é de um campo específico.

string

nullable

message

Mensagem traduzida no locale da requisição.

string

layer

Presente só no 429

string

Allowed values: ip company key operation concurrency

operation

Presente só quando layer=operation

string

Allowed values: report pdf upload

requestId

Identificador da requisição — informe-o ao suporte ao reportar um erro.

string

requiredScope

Presente só no 403 insufficient_scope

string

status

required

Status HTTP da resposta.

integer format: int32

title

required

Título curto e legível do erro.

string

type

required

URI que identifica o tipo do erro.

string

Exemplo

{
  "code": "not_found",
  "detail": "O recurso solicitado não foi encontrado.",
  "errors": [
    {
      "code": "required"
    }
  ],
  "layer": "ip",
  "operation": "report",
  "requestId": "7f3a9c2e-4b1d-4f7a-9e0c-2b8d6a1f3c55",
  "status": 404,
  "title": "Recurso não encontrado",
  "type": "https://developers.mspdesk.com.br/erros/#not_found"
}

Cabeçalhos

RateLimit-Limit

integer format: int32

Capacidade do balde mais restritivo consumido nesta requisição

RateLimit-Remaining

integer format: int32

Requisições restantes nesse balde

RateLimit-Reset

integer format: int32

Segundos até o balde encher de novo

401

Chave de API ausente, inválida, revogada ou expirada

Media typeapplication/problem+json

Erro no formato RFC 9457 (application/problem+json).

object

code

required

Código estável do erro, para tratamento programático.

string

detail

required

Explicação legível deste erro específico.

string

errors

Erros de campo — presente quando a falha vem de validação de campo.

Array<object>

object

code

Código estável do erro de campo.

string

Allowed values: required too_long too_short invalid_value invalid_format unknown_field unsupported_operator unsupported_field out_of_range not_found inactive inconsistent_reference not_applicable

field

Campo com erro, em notação de ponto/colchete. Ausente quando o erro não é de um campo específico.

string

nullable

message

Mensagem traduzida no locale da requisição.

string

layer

Presente só no 429

string

Allowed values: ip company key operation concurrency

operation

Presente só quando layer=operation

string

Allowed values: report pdf upload

requestId

Identificador da requisição — informe-o ao suporte ao reportar um erro.

string

requiredScope

Presente só no 403 insufficient_scope

string

status

required

Status HTTP da resposta.

integer format: int32

title

required

Título curto e legível do erro.

string

type

required

URI que identifica o tipo do erro.

string

Exemplo

{
  "code": "not_found",
  "detail": "O recurso solicitado não foi encontrado.",
  "errors": [
    {
      "code": "required"
    }
  ],
  "layer": "ip",
  "operation": "report",
  "requestId": "7f3a9c2e-4b1d-4f7a-9e0c-2b8d6a1f3c55",
  "status": 404,
  "title": "Recurso não encontrado",
  "type": "https://developers.mspdesk.com.br/erros/#not_found"
}

403

Acesso negado: empresa inativa (account_inactive), API pública desabilitada para a empresa (public_api_disabled), escopo liberado só com a API pública (scope_requires_public_api) ou escopo insuficiente (insufficient_scope)

Media typeapplication/problem+json

Erro no formato RFC 9457 (application/problem+json).

object

code

required

Código estável do erro, para tratamento programático.

string

detail

required

Explicação legível deste erro específico.

string

errors

Erros de campo — presente quando a falha vem de validação de campo.

Array<object>

object

code

Código estável do erro de campo.

string

Allowed values: required too_long too_short invalid_value invalid_format unknown_field unsupported_operator unsupported_field out_of_range not_found inactive inconsistent_reference not_applicable

field

Campo com erro, em notação de ponto/colchete. Ausente quando o erro não é de um campo específico.

string

nullable

message

Mensagem traduzida no locale da requisição.

string

layer

Presente só no 429

string

Allowed values: ip company key operation concurrency

operation

Presente só quando layer=operation

string

Allowed values: report pdf upload

requestId

Identificador da requisição — informe-o ao suporte ao reportar um erro.

string

requiredScope

Presente só no 403 insufficient_scope

string

status

required

Status HTTP da resposta.

integer format: int32

title

required

Título curto e legível do erro.

string

type

required

URI que identifica o tipo do erro.

string

Exemplo

{
  "code": "not_found",
  "detail": "O recurso solicitado não foi encontrado.",
  "errors": [
    {
      "code": "required"
    }
  ],
  "layer": "ip",
  "operation": "report",
  "requestId": "7f3a9c2e-4b1d-4f7a-9e0c-2b8d6a1f3c55",
  "status": 404,
  "title": "Recurso não encontrado",
  "type": "https://developers.mspdesk.com.br/erros/#not_found"
}

Cabeçalhos

RateLimit-Limit

integer format: int32

Capacidade do balde mais restritivo consumido nesta requisição

RateLimit-Remaining

integer format: int32

Requisições restantes nesse balde

RateLimit-Reset

integer format: int32

Segundos até o balde encher de novo

404

not_found: o ticket ou o item não existe nesta empresa

Media typeapplication/problem+json

Erro no formato RFC 9457 (application/problem+json).

object

code

required

Código estável do erro, para tratamento programático.

string

detail

required

Explicação legível deste erro específico.

string

errors

Erros de campo — presente quando a falha vem de validação de campo.

Array<object>

object

code

Código estável do erro de campo.

string

Allowed values: required too_long too_short invalid_value invalid_format unknown_field unsupported_operator unsupported_field out_of_range not_found inactive inconsistent_reference not_applicable

field

Campo com erro, em notação de ponto/colchete. Ausente quando o erro não é de um campo específico.

string

nullable

message

Mensagem traduzida no locale da requisição.

string

layer

Presente só no 429

string

Allowed values: ip company key operation concurrency

operation

Presente só quando layer=operation

string

Allowed values: report pdf upload

requestId

Identificador da requisição — informe-o ao suporte ao reportar um erro.

string

requiredScope

Presente só no 403 insufficient_scope

string

status

required

Status HTTP da resposta.

integer format: int32

title

required

Título curto e legível do erro.

string

type

required

URI que identifica o tipo do erro.

string

Exemplo

{
  "code": "not_found",
  "detail": "O recurso solicitado não foi encontrado.",
  "errors": [
    {
      "code": "required"
    }
  ],
  "layer": "ip",
  "operation": "report",
  "requestId": "7f3a9c2e-4b1d-4f7a-9e0c-2b8d6a1f3c55",
  "status": 404,
  "title": "Recurso não encontrado",
  "type": "https://developers.mspdesk.com.br/erros/#not_found"
}

Cabeçalhos

RateLimit-Limit

integer format: int32

Capacidade do balde mais restritivo consumido nesta requisição

RateLimit-Remaining

integer format: int32

Requisições restantes nesse balde

RateLimit-Reset

integer format: int32

Segundos até o balde encher de novo

409

Conflito — unicidade, recurso em uso, ou Idempotency-Key em execução

Media typeapplication/problem+json

Erro no formato RFC 9457 (application/problem+json).

object

code

required

Código estável do erro, para tratamento programático.

string

detail

required

Explicação legível deste erro específico.

string

errors

Erros de campo — presente quando a falha vem de validação de campo.

Array<object>

object

code

Código estável do erro de campo.

string

Allowed values: required too_long too_short invalid_value invalid_format unknown_field unsupported_operator unsupported_field out_of_range not_found inactive inconsistent_reference not_applicable

field

Campo com erro, em notação de ponto/colchete. Ausente quando o erro não é de um campo específico.

string

nullable

message

Mensagem traduzida no locale da requisição.

string

layer

Presente só no 429

string

Allowed values: ip company key operation concurrency

operation

Presente só quando layer=operation

string

Allowed values: report pdf upload

requestId

Identificador da requisição — informe-o ao suporte ao reportar um erro.

string

requiredScope

Presente só no 403 insufficient_scope

string

status

required

Status HTTP da resposta.

integer format: int32

title

required

Título curto e legível do erro.

string

type

required

URI que identifica o tipo do erro.

string

Exemplo

{
  "code": "not_found",
  "detail": "O recurso solicitado não foi encontrado.",
  "errors": [
    {
      "code": "required"
    }
  ],
  "layer": "ip",
  "operation": "report",
  "requestId": "7f3a9c2e-4b1d-4f7a-9e0c-2b8d6a1f3c55",
  "status": 404,
  "title": "Recurso não encontrado",
  "type": "https://developers.mspdesk.com.br/erros/#not_found"
}

Cabeçalhos

RateLimit-Limit

integer format: int32

Capacidade do balde mais restritivo consumido nesta requisição

RateLimit-Remaining

integer format: int32

Requisições restantes nesse balde

RateLimit-Reset

integer format: int32

Segundos até o balde encher de novo

422

business_rule_violation quando o item já está em uma fatura, ticket_not_editable ou ticket_deleted

Media typeapplication/problem+json

Erro no formato RFC 9457 (application/problem+json).

object

code

required

Código estável do erro, para tratamento programático.

string

detail

required

Explicação legível deste erro específico.

string

errors

Erros de campo — presente quando a falha vem de validação de campo.

Array<object>

object

code

Código estável do erro de campo.

string

Allowed values: required too_long too_short invalid_value invalid_format unknown_field unsupported_operator unsupported_field out_of_range not_found inactive inconsistent_reference not_applicable

field

Campo com erro, em notação de ponto/colchete. Ausente quando o erro não é de um campo específico.

string

nullable

message

Mensagem traduzida no locale da requisição.

string

layer

Presente só no 429

string

Allowed values: ip company key operation concurrency

operation

Presente só quando layer=operation

string

Allowed values: report pdf upload

requestId

Identificador da requisição — informe-o ao suporte ao reportar um erro.

string

requiredScope

Presente só no 403 insufficient_scope

string

status

required

Status HTTP da resposta.

integer format: int32

title

required

Título curto e legível do erro.

string

type

required

URI que identifica o tipo do erro.

string

Exemplo

{
  "code": "not_found",
  "detail": "O recurso solicitado não foi encontrado.",
  "errors": [
    {
      "code": "required"
    }
  ],
  "layer": "ip",
  "operation": "report",
  "requestId": "7f3a9c2e-4b1d-4f7a-9e0c-2b8d6a1f3c55",
  "status": 404,
  "title": "Recurso não encontrado",
  "type": "https://developers.mspdesk.com.br/erros/#not_found"
}

Cabeçalhos

RateLimit-Limit

integer format: int32

Capacidade do balde mais restritivo consumido nesta requisição

RateLimit-Remaining

integer format: int32

Requisições restantes nesse balde

RateLimit-Reset

integer format: int32

Segundos até o balde encher de novo

429

Limite de uso atingido (rate_limited); o campo layer indica a camada: ip, company, key, operation ou concurrency

Media typeapplication/problem+json

Erro no formato RFC 9457 (application/problem+json).

object

code

required

Código estável do erro, para tratamento programático.

string

detail

required

Explicação legível deste erro específico.

string

errors

Erros de campo — presente quando a falha vem de validação de campo.

Array<object>

object

code

Código estável do erro de campo.

string

Allowed values: required too_long too_short invalid_value invalid_format unknown_field unsupported_operator unsupported_field out_of_range not_found inactive inconsistent_reference not_applicable

field

Campo com erro, em notação de ponto/colchete. Ausente quando o erro não é de um campo específico.

string

nullable

message

Mensagem traduzida no locale da requisição.

string

layer

Presente só no 429

string

Allowed values: ip company key operation concurrency

operation

Presente só quando layer=operation

string

Allowed values: report pdf upload

requestId

Identificador da requisição — informe-o ao suporte ao reportar um erro.

string

requiredScope

Presente só no 403 insufficient_scope

string

status

required

Status HTTP da resposta.

integer format: int32

title

required

Título curto e legível do erro.

string

type

required

URI que identifica o tipo do erro.

string

Exemplo

{
  "code": "not_found",
  "detail": "O recurso solicitado não foi encontrado.",
  "errors": [
    {
      "code": "required"
    }
  ],
  "layer": "ip",
  "operation": "report",
  "requestId": "7f3a9c2e-4b1d-4f7a-9e0c-2b8d6a1f3c55",
  "status": 404,
  "title": "Recurso não encontrado",
  "type": "https://developers.mspdesk.com.br/erros/#not_found"
}

Cabeçalhos

RateLimit-Limit

integer format: int32

Capacidade do balde mais restritivo consumido nesta requisição

RateLimit-Remaining

integer format: int32

Requisições restantes nesse balde

RateLimit-Reset

integer format: int32

Segundos até o balde encher de novo

Retry-After

integer format: int32

Segundos até poder repetir

500

Erro interno inesperado

Media typeapplication/problem+json

Erro no formato RFC 9457 (application/problem+json).

object

code

required

Código estável do erro, para tratamento programático.

string

detail

required

Explicação legível deste erro específico.

string

errors

Erros de campo — presente quando a falha vem de validação de campo.

Array<object>

object

code

Código estável do erro de campo.

string

Allowed values: required too_long too_short invalid_value invalid_format unknown_field unsupported_operator unsupported_field out_of_range not_found inactive inconsistent_reference not_applicable

field

Campo com erro, em notação de ponto/colchete. Ausente quando o erro não é de um campo específico.

string

nullable

message

Mensagem traduzida no locale da requisição.

string

layer

Presente só no 429

string

Allowed values: ip company key operation concurrency

operation

Presente só quando layer=operation

string

Allowed values: report pdf upload

requestId

Identificador da requisição — informe-o ao suporte ao reportar um erro.

string

requiredScope

Presente só no 403 insufficient_scope

string

status

required

Status HTTP da resposta.

integer format: int32

title

required

Título curto e legível do erro.

string

type

required

URI que identifica o tipo do erro.

string

Exemplo

{
  "code": "not_found",
  "detail": "O recurso solicitado não foi encontrado.",
  "errors": [
    {
      "code": "required"
    }
  ],
  "layer": "ip",
  "operation": "report",
  "requestId": "7f3a9c2e-4b1d-4f7a-9e0c-2b8d6a1f3c55",
  "status": 404,
  "title": "Recurso não encontrado",
  "type": "https://developers.mspdesk.com.br/erros/#not_found"
}

Cabeçalhos

RateLimit-Limit

integer format: int32

Capacidade do balde mais restritivo consumido nesta requisição

RateLimit-Remaining

integer format: int32

Requisições restantes nesse balde

RateLimit-Reset

integer format: int32

Segundos até o balde encher de novo