Postos / Workplaces

Cadastro / Add

[PT] Este serviço permite o cadastro de um Posto. Um JSON no formato abaixo relacionado deve ser enviado como payload. Os campos obrigatórios estão marcados com um "*" na aba "Model".

[EN] Creates a new workplace. The payload to be sent is the bellow JSON. Required fields have a asterisk mark "*" in "Model" tab.

post/workplaces

Request

  • Base URL: https://api.nexti.com
  • URL: https://api.nexti.com/workplaces
  • Auth: OAuth 2 (client credentials, token URL https://api.nexti.com/security/oauth/token)

Request body

idinteger

[PT]ID do posto [EN]Workplace ID

externalIdstring

[PT]ID externo do posto [EN]External workplace ID

workplaceNumberinteger

[PT]Número do posto (formato numérico) [EN]Workplace number (numeric format)

contractNumberinteger

[PT]Número do contrato (formato numérico) [EN]Contract number (numeric format)

clientIdinteger required

[PT]ID do cliente [EN]Client ID

clientNamestring required

[PT]Nome do cliente [EN]Client name

externalClientIdstring required

[PT]ID externo do cliente [EN]Client external ID

namestring required

[PT]Nome do posto [EN]Workplace name

servicestring

[PT]Serviço [EN]Service

citystring

[PT]Nome da cidade [EN]City name

statestring

[PT]Estado [EN]State

vacantJobinteger

[PT]Vagas [EN]Vacant job

businessUnitIdinteger required

[PT]Unidade de negócio [EN]Business unit

externalBusinessUnitIdstring required

[PT]ID externo da Unidade de negócio [EN]Business unit external ID

zipCodestring

[PT]Código postal [EN]Zip code

addressstring

[PT]Endereço [EN]Address

addressNumberstring

[PT]Número do endereço [EN]Address number

addressTypeIdinteger required

[PT]ID do tipo de endereço [EN]Address type ID

costCenterstring

[PT]Centro de custo [EN]Cost center

districtstring

[PT]Bairro [EN]District

serviceTypeIdinteger required

ID do tipo de serviço. [EN]Service type ID. Values:

externalServiceTypeIdstring

[PT]ID externo do tipo de serviço [EN]Service type external ID

timezonestring required

[PT]Timezone [EN]Timezone

startDatestring

[PT]Data de inicio do posto [EN]Workplace start date

finishDatestring

[PT]Data de termino do posto [EN]Workplace finish date

companyIdinteger

[PT]ID da empresa [EN]Company ID

externalCompanyIdstring

[PT]ID externo da empresa [EN]External company ID

fractionalVacancyboolean

[PT]Vagas fracionadas [EN]Fractional vacancy

forceCompanyReplacementboolean

[PT]Forçar cobertura na mesma empresa [EN]Force replacement in the same company

forceCompanyTransferboolean

[PT]Forçar transferência na mesma empresa [EN]Force transfer in the same company

externalAlarmIdstring

[PT]ID externo da conta de alarme [EN]External alarm ID

cityIdinteger

ID da cidade. [EN]City ID.

cityExternalIdstring

[PT]ID externo da cidade [EN]City external ID

cityNamestring

[PT]Nome da cidade [EN]City name

federatedUnitIdinteger

ID do UF. [EN]Federated unit ID.

federatedUnitExternalIdstring

[PT]ID externo do UF [EN]Federated unit external ID

federatedUnitNamestring

[PT]Nome do UF [EN]Federated unit name

federatedUnitInitialsstring

[PT]Silga do UF [EN]Federated unit initials

managerNamestring

[PT]Nome do gestor do posto [EN]Manager name

managerPhonestring

[PT]Telefone do gestor do posto [EN]Manager phone

controlLackOfEffectivenessboolean

[PT]Emitir alerta para posto sem colaboradores efetivos [EN]Issue alert to station without effective employees

generateVirtualClockingboolean

[PT]Gerar marcação virtual no lugar de esquecimento [EN]Generate virtual markup instead of forgetting

checkinToleranceinteger

[PT]Tolerância de entrada em minutos [EN] Input Tolerance in Minutes

checkoutToleranceinteger

[PT]Tolerância de saída em minutos [EN] Output Tolerance in Minutes

companyNamestring

[PT]Nome da empresa [EN]Company name

companyNumberstring

[PT]Número da empresa [EN]Company Number

departmentstring

[PT]Departamento [EN]Department

workplaceNumberTxtstring

[PT]Número do posto (formato alfanumérico) [EN]Workplace number (alphanumeric format)

contractNumberTxtstring

[PT]Número do contrato (formato alfanumérico) [EN]Contract number (alphanumeric format)

workplaceClosingReasonIdinteger

[PT]ID do motivo de encerramento de posto [EN]Workplace closing reason ID

workplaceClosingReasonNamestring

[PT]Nome do motivo de encerramento de posto [EN]Workplace closing reason name

workplaceClosingReasonExternalIdstring

[PT]ID externo do motivo de encerramento de posto [EN]Workplace closing reason external ID

closingNotestring

[PT]Nota de encerramento de posto [EN]Workplace closing note

ordinationstring

[PT]Ordem de exibição na mesa [EN]Operation Desk ordination

activeboolean

[PT]Ativo [EN]Active

phonestring

[PT]Telefone [EN]Phone

phone2string

[PT]Telefone2 [EN]Phone2

latitudestring

[Pt]Latitude do posto. [EN]Workplace latitude.

longitudestring

[PT]Longitude do posto. [EN]Workplace longitude.

generateFlexibleInconsistenciesAlertboolean

[PT]Gerar alerta de inconsistências para horário flexível [EN]Generate inconsistencies alert for flexible shift

maximumPerimeterRecordMarkinginteger

[PT]Perímetro máximo para marcação de ponto [EN]Maximum perimeter for point marking

initialScheduleAdjustmentboolean

[PT]Início da jornada [EN]Shift start

intervalScheduleAdjustmentboolean

[PT]Intrajornada [EN]Break schedule

finalScheduleAdjustmentboolean

[PT]Fim da jornada [EN]Shift end

alterBonusForReplacementboolean

[PT]Alterar perfil em caso de coberturas de gratificação [EN]Change profile in case of bonus coverage

showWorkplaceInPersonInformationAppboolean

[PT]Mostrar posto em “Informações do colaborador” no aplicativo [EN]Show workplace in the app's "Person Information" tab

createMaximumPerimeterToRecordMarkingboolean

[PT]Mostrar Perímetro máximo para marcação de ponto [EN]Show maximum perimeter for point marking

complementstring

[PT]Complemento do endereço do posto. [EN]Complement of the workplace address.

responsibleReceptionstring

[PT]Responsável pelo posto. [EN]Responsible for the workplace.

registerDatestring

[PT]Data de registro [EN]Register date

lastUpdatestring

[PT]Data da última alteração [EN]Last Update date

Example request

{
  "timezone": "America/Sao_Paulo",
  "startDate": "ddMMyyyyHHmmss",
  "finishDate": "ddMMyyyyHHmmss",
  "workplaceVacancies": [
    {
      "finishDateTime": "ddMMyyyyHHmmss",
      "startDateTime": "ddMMyyyyHHmmss",
      "careerDtoList": [
        {
          "registerDate": "ddMMyyyyHHmmss",
          "lastUpdate": "ddMMyyyyHHmmss"
        }
      ],
      "scheduleDtoList": [
        {
          "rotations": [
            {
              "baseDateTime": "ddMMyyyyHHmmss"
            }
          ],
          "registerDate": "ddMMyyyyHHmmss",
          "lastUpdate": "ddMMyyyyHHmmss"
        }
      ]
    }
  ],
  "holidays": [
    {
      "holidayDate": "ddMMyyyy",
      "registerDate": "ddMMyyyyHHmmss",
      "lastUpdate": "ddMMyyyyHHmmss"
    }
  ],
  "persons": [
    {
      "gender": "'M', 'F'",
      "birthDate": "ddMMyyyyHHmmss",
      "admissionDate": "ddMMyyyyHHmmss",
      "demissionDate": "ddMMyyyyHHmmss",
      "issueDateRegisterNumber": "ddMMyyyyHHmmss",
      "initialsRegisterNumber": "RJ",
      "maritalStatusExternalId": "002",
      "maritalStatusName": "Solteiro",
      "publicArea": "Rua, avenida, Travessa",
      "federatedUnitInitials": "SC, SP",
      "markings": [
        480,
        720,
        760,
        880
      ],
      "referenceDate": "YYYY-MM-DD",
      "ignoreTimeTrackingDate": "ddMMyyyyHHmmss"
    }
  ],
  "registerDate": "ddMMyyyyHHmmss",
  "lastUpdate": "ddMMyyyyHHmmss"
}

Response

OK

idinteger

ID do response

messagestring

Mensagem do response

commentsstring[]

Comentários do response

Example response

{
  "value": {
    "timezone": "America/Sao_Paulo",
    "startDate": "ddMMyyyyHHmmss",
    "finishDate": "ddMMyyyyHHmmss",
    "workplaceVacancies": [
      {
        "finishDateTime": "ddMMyyyyHHmmss",
        "startDateTime": "ddMMyyyyHHmmss",
        "careerDtoList": [
          {
            "registerDate": "ddMMyyyyHHmmss",
            "lastUpdate": "ddMMyyyyHHmmss"
          }
        ],
        "scheduleDtoList": [
          {
            "rotations": [
              {
                "baseDateTime": "ddMMyyyyHHmmss"
              }
            ],
            "registerDate": "ddMMyyyyHHmmss",
            "lastUpdate": "ddMMyyyyHHmmss"
          }
        ]
      }
    ],
    "holidays": [
      {
        "holidayDate": "ddMMyyyy",
        "registerDate": "ddMMyyyyHHmmss",
        "lastUpdate": "ddMMyyyyHHmmss"
      }
    ],
    "persons": [
      {
        "gender": "'M', 'F'",
        "birthDate": "ddMMyyyyHHmmss",
        "admissionDate": "ddMMyyyyHHmmss",
        "demissionDate": "ddMMyyyyHHmmss",
        "issueDateRegisterNumber": "ddMMyyyyHHmmss",
        "initialsRegisterNumber": "RJ",
        "maritalStatusExternalId": "002",
        "maritalStatusName": "Solteiro",
        "publicArea": "Rua, avenida, Travessa",
        "federatedUnitInitials": "SC, SP",
        "markings": [
          480,
          720,
          760,
          880
        ],
        "referenceDate": "YYYY-MM-DD",
        "ignoreTimeTrackingDate": "ddMMyyyyHHmmss"
      }
    ],
    "registerDate": "ddMMyyyyHHmmss",
    "lastUpdate": "ddMMyyyyHHmmss"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.